Batch Adding or Deleting Whitelist Records¶

Function¶

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

Note

Your account ID is in the whitelist of your own VPC endpoint service by default.

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

Table 1 describes parameters in this URI.

**Table 1** URI parameters¶
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
vpc_endpoint_service_id	Yes	Specifies the ID of the VPC endpoint service.

Parameter description

**Table 2** Request parameters¶
Parameter	Mandatory	Type	Description
permissions	Yes	Array of strings	Lists the whitelist records. The record is in the iam:domain::domain_id format. Fields are described as follows: iam:domain:: is fixed. domain_id indicates the account ID of the target user. The value contains 1 to 64 characters, including letters, digits, and asterisks (``). If you enter an asterisk, this VPC endpoint service allows access from any VPC endpoints. Example: iam:domain::6e9dfd51d1124e8d8498dce894923a0dd*
action	Yes	String	Specifies the operation to be performed. The value is add or remove.

Example request

This request is to add a whitelist record to the VPC endpoint service whose ID is 4189d3c2-8882-4871-a3c2-d380272eed88.

POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions/action

{
    "permissions":
      [
        "iam:domain::fc973eea581490997e82ea11a1d0101"
      ],
    "action":"add"
}

This request is to delete a whitelist record from the VPC endpoint service whose ID is 4189d3c2-8882-4871-a3c2-d380272eed88.

POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions/action

{
  "permissions":
    [
      "iam:domain::5fc973eea581490997e82ea11a1d0101"
    ],
   "action":"remove"
}

Parameter description

**Table 3** Response parameter¶
Parameter	Type	Description
permissions	Array of strings	Lists the whitelist records. The permission format is iam:domain:: 6e9dfd51d1124e8d8498dce894923a0d or . indicates all users can connect to the VPC endpoint service. 6e9dfd51d1124e8d8498dce894923a0d indicates the domain ID of the user.

Example response

{
  "permissions":
    [
      "iam:domain::5fc973eea581490997e82ea11a1d0101",
      "iam:domain::5fc973eea581490997e82ea11a1d0102"
      ]
}

last updated: 2025-04-08 09:30 UTC - commit: f56083f8cfcc66f305c1e02257216144484f782b