Skip to content

Latest commit

 

History

History
70 lines (47 loc) · 1.65 KB

nic_create.rst

File metadata and controls

70 lines (47 loc) · 1.65 KB
Raw

nic_create

POST users/{uid}/appliances/{aid}/installProfile/{ipid}/nics

Summary

  • Method: POST
  • Response Code: 201
  • Response Formats: application/xml application/json
  • Since: UForge 3.7

Creates a new network interface card (NIC) for an appliance.

The NIC information is stored in the install profile of the appliance.

Please refer to nic-object for a complete list of all the nic attributes.

Security Summary

  • Requires Authentication: true
  • Entitlements Required: appliance_create

URI Parameters

  • uid (required): the user name (login name) of the user-object
  • ipid (required): the id of the installprofile-object
  • aid (required): the id of the appliance-object

HTTP Request Body Parameters

A nic-object object

Example Request

curl "https://uforge.example.com/apiusers/{uid}/appliances/{aid}/installProfile/{ipid}/nics" -X POST \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml" --data-binary "@representation.xml"

Example of representation.xml content (the request body):

<ns0:nic xmlns:ns0="http://www.usharesoft.com/uforge">
    <type>ETHERNET</type>
    <ipv4Method>AUTOMATIC</ipv4Method>
    <ipv6Method>IGNORE</ipv6Method>
</ns0:nic>
  • appliance-object
  • installprofile-object
  • nic-object
  • nic-delete
  • nic-get
  • nic-getAll
  • nic-update
  • nic-updateList
  • user-object