Deleting NICs from an ECS in a Batch

Updated on 2023-05-29 GMT+08:00

View PDF

This API is used to uninstall and delete one or multiple NICs from an ECS.

The primary NIC of an ECS has routing rules configured and cannot be deleted.

POST /v1/{project_id}/cloudservers/{server_id}/nics/delete

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.

Table 2 describes the request parameters.

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
nics	Yes	Array of objects	Specifies the NICs to be deleted. For details, see Table 3.

**Table 3** **nics** field description
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.

POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/nics/delete

{
    "nics": [
         {
            "id": "d32019d3-bc6e-4319-9c1d-6722fc136a23"
        }
    ]
}

{      
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

Parent topic: NIC Management

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel