Help Center/ Elastic Cloud Server/ API Reference (Ankara Region)/ Native OpenStack Nova APIs/ NIC Management/ Deleting a NIC from an ECS
Updated on 2024-04-16 GMT+08:00
View PDF
Share

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, the NIC that is attached to the ECS and specified by port_id through the OpenStack Nova API will be retained, and the NIC specified by net_id will be deleted.

URI

DELETE /v2.1/{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.

For details about how to obtain the ID, see Obtaining a 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 a NIC from an ECS based on the specified 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.

Parent topic: NIC Management