Help Center/ CodeArts/ API Reference/ API/ VPC Endpoint Management/ Deleting VPCEP Access Control Information
Updated on 2025-12-18 GMT+08:00

Deleting VPCEP Access Control Information

Function

This API is used to delete a private network security access control policy. Make sure the security access control policy does exist.

Calling Method

For details, see Calling APIs.

URI

DELETE /devuc-accessmgmt/v2/vpceps

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token. (The value of the X-Subject-Token response header is the user token.) It can be obtained by calling the API forobtaining an IAM user token.

Constraints

Global tenant tokens are not supported. Use a region-level token whose scope is project.

Range

N/A.

Default Value

N/A.

region

Yes

String

Definition

Region where the VPC endpoint to be deleted is located. It can be found from the region column in the Endpoint list.

Constraints

N/A.

Range

Enter 1 to 40 characters. Only digits, letters, and hyphens (-) are allowed.

Default Value

N/A.

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

enterprise_id

No

String

Definition

Tenant ID. For details about how to obtain the account ID, see Obtaining an Account ID.

Constraints

N/A.

Range

Enter 1 to 40 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed.

Default Value

N/A.

vpceps

No

Array of VpcepRequestInfo objects

Definition

List of authorized VPC endpoints.

Constraints

N/A.

Table 3 VpcepRequestInfo

Parameter

Mandatory

Type

Description

description

No

String

Definition

VPC endpoint description.

Constraints

N/A.

Range

Enter 0 to 128 characters. Use only letters, digits, spaces, and these special characters: ()[]-_~.&;

Default Value

N/A.

vpcep_id

No

String

Definition

VPC endpoint ID. Find it from the All Account Settings > General > Private Access page.

Constraints

N/A.

Range

Enter 1 to 40 characters. Only use digits, lower-case letters, and hyphens (-).

Default Value

N/A.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

status

String

Definition

Status.

Range

ok: The API is successfully called.

total

Integer

Definition

Total count.

Range

N/A.

Status code: 401

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

Range

N/A.

error_msg

String

Definition

Error message.

Range

N/A.

Status code: 404

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

Range

N/A.

error_msg

String

Definition

Error message.

Range

N/A.

Example Requests

DELETE https://{endpoint}/v2/vpceps

{
  "enterprise_id" : "abcdbfa39r7pg09la8msyu8vq004aabcd",
  "vpceps" : [ {
    "vpcep_id" : "1234bfa39r7pg09la8msyu8vq004a1234"
  } ]
}

Example Responses

Status code: 200

Deleted.

{
  "status" : "ok",
  "total" : 1
}

Status Codes

Status Code

Description

200

Deleted.

401

Unauthorized

404

NotFound

Error Codes

See Error Codes.