Help Center/ Virtual Private Cloud/ API Reference/ VPC APIs (V1/V2)/ Port/ Deleting a Port
Updated on 2025-10-23 GMT+08:00
View PDF

Deleting a Port

Function

This API is used to delete a port. A port is used to carry private IP addresses in a subnet.

Constraints

  • If device_owner is not empty, the port cannot be deleted. However, there is a special case. If device_owner is neutron:VIP_PORT, the port can be deleted.
  • If device_id is not empty, the port cannot be deleted.

URI

DELETE /v1/{project_id}/ports/{port_id}

Table 1 describes the parameters.
Table 1 Parameter description

Parameter

Mandatory

Description

port_id

Yes

Specifies the port ID that uniquely identifies the port.

project_id

Yes

Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

Request Parameters

None

Example Request

DELETE https://{Endpoint}/v1/{project_id}/ports/d00f9c13-412f-4855-8af3-de5d8c24cd60

Response Parameters

None

Example Response

None

Status Code

See Status Codes.

Error Code

See Error Codes.

Parent Topic: Port