Adding NICs to an ECS in a Batch
Function
This API is used to add one or multiple NICs to an ECS.
This API is an asynchronous API. After the NIC addition request is successfully delivered, a job ID is returned. This does not mean the NIC addition is complete. You need to call the API by referring to Querying Task Execution Status to query the job status. The SUCCESS status indicates that the NIC addition is successful.
URI
POST /v1/{project_id}/cloudservers/{server_id}/nics
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
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
nics |
Yes |
Array of objects |
Specifies the NICs to be added. For details, see Table 3. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
subnet_id |
Yes |
String |
Specifies the information about the NICs to be added to an ECS. The value must be the ID of a created network in UUID format. |
security_groups |
No |
Array of objects |
Specifies the security groups for NICs. For details, see Table 4. |
ip_address |
No |
String |
Specifies the IP address. If this parameter is unavailable, the IP address is automatically assigned. |
ipv6_enable |
No |
Boolean |
Indicates whether to support IPv6 addresses. If this parameter is set to true, the NIC supports IPv6 addresses. |
ipv6_bandwidth |
No |
Object |
Specifies the bound shared bandwidth. For details, see ipv6_bandwidth Field Description. |
Response
See Responses (Task).
Example Request
Add the NIC whose ID is d32019d3-bc6e-4319-9c1d-6722fc136a23 and security group ID is f0ac4394-7e4a-4409-9701-ba8be283dbc3 to an ECS.
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/nics { "nics": [ { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "security_groups": [ { "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3" } ] } ] }
Example Response
{ "job_id": "ff80808288d41e1b018990260955686a" }
Returned Values
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot