Updated on 2025-12-23 GMT+08:00

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.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    vpc:ports:delete

    Write

    port *

    -

    -

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.