Help Center/ Virtual Private Cloud/ API Reference/ VPC APIs (V1/V2)/ Subnet/ Deleting a Subnet
Updated on 2025-12-23 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Deleting a Subnet

Function

This API is used to delete a subnet.

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:subnets:delete

    Write

    subnet *

    -

    -

URI

DELETE /v1/{project_id}/vpcs/{vpc_id}/subnets/{subnet_id}

Table 1 describes the parameters.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

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

vpc_id

Yes

Specifies the ID of the subnet VPC.

subnet_id

Yes

Specifies the subnet ID, which uniquely identifies the subnet.

If you use the management console, the value of this parameter is the Network ID value.

Request Parameters

None

Example Request

DELETE https://{Endpoint}/v1/{project_id}/vpcs/{vpc_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d

Response Parameters

None

Example Response

None

Status Code

See Status Codes.

Error Code

See Error Codes.

Parent Topic: Subnet