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

Deleting a VPC Peering Connection

Function

This API is used to delete a VPC peering connection.

A VPC peering connection can be deleted either by the local or peer tenant.

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

    Write

    peering *
    • vpc:AccepterVpcId
    • vpc:RequesterVpcId
    • vpc:PeeringId

    -

    -

URI

DELETE /v2.0/vpc/peerings/{peering_id}

Table 1 describes the parameters.
Table 1 Parameter description

Parameter

Mandatory

Type

Description

peering_id

Yes

String

Specifies the VPC peering connection ID, which uniquely identifies the VPC peering connection.

Request Parameters

None

Example Request

DELETE https://{Endpoint}/v2.0/vpc/peerings/2b098395-046a-4071-b009-312bcee665cb

Response Parameters

None

Example Response

None

Status Code

See Status Codes.

Error Code

See Error Codes.

Parent Topic: VPC Peering Connection