Deleting a NIC from an ECS

Function

This API is used to delete a NIC from an ECS based on the port ID.

Constraints

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

When an ECS NIC is detached, all NICs attached to the ECS through the OpenStack Nova API will be deleted.

URI

DELETE /v2.1/{project_id}/servers/{server_id}/os-interface/{port_id}{?reserve_port}

DELETE /v2/{project_id}/servers/{server_id}/os-interface/{port_id}{?reserve_port}

Table 1 describes the parameters in the URI.

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

server_id

Yes

Specifies the ECS ID.

port_id

Yes

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.

reserve_port

No

Indicates whether to retain the NIC port after the NIC is unbound.

True: indicates that the port is reserved.

False: indicates that the port is deleted. This is the default value.

Request

None

Response

None

Example Request

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

Example Response

None

Returned Values

See Returned Values for General Requests.