Batch Adding Tags to or Deleting Tags from a Specified Resource

Function

This API is used to batch add tags to or delete tags from a specified VPC endpoint service or VPC endpoint.

• You can add up to 20 tags to a resource.

URI

POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action

Table 1 describes parameters in this URI.

Request

• Parameter description

  Table 2 Request parameters

  Parameter	Mandatory	Type	Description
  tags	No	List<resource_tag>	Lists the tags. This parameter is mandatory for common tenants.
  action	Yes	String	Specifies the operation to be performed, which can be create or delete

  Table 3 Data structure of field resource_tag

  Parameter	Mandatory	Type	Description
  key	Yes	String	Specifies the tag key. A tag key contains a maximum of 128 Unicode characters. The key meets the requirements in Tag Character Set Specifications.
  value	This parameter is mandatory when action is set to create and optional when action is set to delete.)	String	Specifies the tag value. Each tag key contains a maximum of 255 Unicode characters. If value is specified, tags are deleted by key and value. If value is not specified, tags are deleted by key. The value meets the requirements in Tag Character Set Specifications.

• Example request

  POST https://{endpoint}/v1/{project_id}/endpoint_service/{resource_id}/tags/action

  or https://{endpoint}/v1/{project_id}/endpoint/{resource_id}/tags/action

  POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action

  {
      "action": "create",
      "tags": [
          {
              "key": "key1",
              "value": "value1"
          },
          {
              "key": "key",
              "value": "value3"
          }
  ]
  }

  or

  {
      "action": "delete",
      "tags": [
          {
              "key": "key1"
           },
          {
              "key": "key2",
              "value": "value3"
          }
  ]
  }

Response

None

Status Codes

See Status Codes.

Error Codes

For details, see Error Codes.