Deleting NICs from an ECS in a Batch
Function
This API is used to uninstall and delete one or multiple NICs from an ECS.
Constraints
The primary NIC of an ECS has routing rules configured and cannot be deleted.
URI
POST /v1/{project_id}/cloudservers/{server_id}/nics/delete
Table 1 describes the parameters in the URI.
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.
Parameter | Mandatory | Type | Description |
---|---|---|---|
nics | Yes | Array of objects | Specifies the NICs to be deleted. For details, see Table 3. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
id | Yes | String | Specifies the port ID of the NIC. NOTE: When the ID is the same as the ECS primary NIC ID, the system will return error code 403. |
Response
See Responses (Task).
Example Request
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/nics/delete
{"nics": [{"id": "d32019d3-bc6e-4319-9c1d-6722fc136a23"}]}
Example Response
None
Returned Values
Error Codes
See Error Codes.
- Function
- Constraints
- URI
- Request
- Response
- Example Request
- Example Response
- Returned Values
- Error Codes