Help Center/ VPC Endpoint/ API Reference/ API/ VPC Endpoint Services/ Batch Deleting Whitelist Records of a VPC Endpoint Service

Updated on 2025-05-15 GMT+08:00

View PDF

Batch Deleting Whitelist Records of a VPC Endpoint Service

Function

This API is used to batch delete whitelist records of a VPC endpoint service.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions/batch-delete

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the project ID.
vpc_endpoint_service_id	Yes	String	Specifies the ID of the VPC endpoint service.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token.
Content-Type	No	String	Specifies the MIME type of the request body. Default value application/json is recommended. For APIs used to upload objects or images, the MIME type varies depending on the flow type.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
permissions	Yes	Array of EpsRemovePermissionRequest objects	Specifies the whitelist of the VPC endpoint service.

**Table 4** EpsRemovePermissionRequest
Parameter	Mandatory	Type	Description
id	Yes	String	Specifies primary key IDs of whitelist records of a VPC endpoint service.

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
permissions	Array of EpsPermission objects	Specifies the whitelist of the VPC endpoint service.

**Table 6** EpsPermission
Parameter	Type	Description
id	String	Specifies primary key IDs of whitelist records of a VPC endpoint service.
permission	String	The permission format is iam:domain::domain_id or organizations:orgPath::org_path. iam:domain:: and organizations:orgPath:: are fixed formats. domain_id indicates the ID of the account in which VPC endpoints can be created to access the VPC endpoint service. org_path indicates the organization path under which accounts can create VPC endpoints to access the VPC endpoint service. domain_id can contain only letters and digits. org_path can contain only letters, digits, forward slashes (/), and hyphens (-). You can also enter an asterisk () for domain_id or org_path, which indicates that this VPC endpoint service allows accesses from any VPC endpoint. Example: iam:domain::6e9dfd51d1124e8d8498dce894923a0dd or organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/
permission_type	String	Specifies the whitelist type of the VPC endpoint service. domainId: indicates the whitelisted ID of the account that can create VPC endpoints to connect to the VPC endpoint service. orgPath: indicates the whitelisted organization path under which accounts can create VPC endpoints to connect to the VPC endpoint service.
description	String	Specifies the description of a whitelist record of a VPC endpoint service.
created_at	String	Specifies the time when a whitelist record is created.

Example Requests

Batch deleting whitelist records of a VPC endpoint service

POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/c07132bf-4071-439a-9ff3-2068eb45092f/permissions/batch-delete

{
  "permissions" : [ {
    "id" : "b9b6f264-3562-4f62-ba84-c128da20d18d"
  }, {
    "id" : "c07132bf-4071-439a-9ff3-2068eb45092f"
  } ]
}