Adding a NIC to an ECS

Function

This API is used to add a NIC to an ECS.

To view application examples about ECS NIC applications, see Attaching a NIC to an ECS.

URI

POST /v2.1/{project_id}/servers/{server_id}/os-interface

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID.
server_id	Yes	Specifies the ECS ID.

Request

Table 2 describes the request parameters.

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
interfaceAttachment	Yes	Object	Specifies the NICs to be added. For details, see Table 3.

**Table 3** **interfaceAttachment** field description
Parameter	Mandatory	Type	Description
port_id	No	String	Specifies the port ID. The port_id and net_id cannot be specified at the same time.
net_id	No	String	Specifies the network ID. The port_id and net_id cannot be specified at the same time.
fixed_ips	No	Array of objects	Specifies a private IP address. This parameter cannot be specified when port_id is used. This parameter must be used with net_id. Only the first element in the list is valid. If two or more elements are used, an error will be reported. For details, see Table 4.

**Table 4** **fixed_ips** field description
Parameter	Mandatory	Type	Description
ip_address	No	String	Specifies the IP address.

Response

Table 5 describes the response parameters.

**Table 5** Response parameters
Parameter	Type	Description
interfaceAttachment	Object	Specifies ECS NICs. For details, see Table 6.

**Table 6** **interfaceAttachment** field description
Parameter	Type	Description
port_state	String	Specifies the port state.
fixed_ips	Array of objects	Specifies IP addresses for NICs. For details, see Table 7.
port_id	String	Specifies the port ID.
net_id	String	Specifies the network ID.
mac_addr	String	Specifies the MAC address.

**Table 7** **fixed_ips** field description
Parameter	Type	Description
subnet_id	String	Specifies the ID of the subnet used by the NIC.
ip_address	String	Specifies the NIC IP address.

Example Request

Add a NIC whose network ID is 3cb9bc59-5699-4588-a4b1-b87f96708bc6.

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface

{
    "interfaceAttachment" : {
        "fixed_ips" : [ 
            {
                "ip_address" : "192.168.1.3"
            } 
         ],
    "net_id" : "3cb9bc59-5699-4588-a4b1-b87f96708bc6"
    }
}

Add a NIC whose port ID is ce531f90-199f-48c0-816c-13e38010b442.

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface

{
    "interfaceAttachment" : {
        "fixed_ips" : [ 
            {
                "ip_address" : "192.168.1.3"
            } 
         ],
    "port_id" : "ce531f90-199f-48c0-816c-13e38010b442"
    }
}

Example Response

{
    "interfaceAttachment": {
        "port_state": "DOWN",
        "fixed_ips": [
            {
                "subnet_id": "d9cfef77-0151-4c2a-9ed5-d951ada8adf3",
                "ip_address": "10.0.1.11"
            }
        ],
        "port_id": " ce531f90-199f-48c0-816c-13e38010b442",
        "net_id": "0dc714fa-9022-4a03-bb22-9821a396bb9d",
        "mac_addr": "fa:16:3e:63:75:b2"
    }
}