Function

This API is used to add or delete tags in batches for a specified resource. A maximum of 10 tags can be added for one resource.

URI

POST /v1.0/{project_id}/clusters/{resource_id}/tags/action

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
resource_id	Yes	String	Resource ID, for example, 7d85f602-a948-4a30-afd4-e84f47471c15.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
tags	Yes	List<ResourceTag>	Tag list.
action	Yes	String	Identifies the operation. The value can be create or delete. create: adds tags in batches. delete: deletes tags in batches.

**Table 3** resource_tag
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. A tag key can contain a maximum of 36 Unicode characters, which cannot be null. The first and last characters cannot be spaces. It can contain only letters, digits, hyphens (-), and underscores (_).
value	Yes	String	Key value. A tag value can contain a maximum of 43 Unicode characters, which can be null. The first and last characters cannot be spaces. It can contain only letters, digits, hyphens (-), and underscores (_).

Response Parameters

None

Example Request

Sample request for adding tags in batches

POST /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/7d85f602-a948-4a30-afd4-e84f47471c15/tags/action
{
    "action": "create",
    "tags": [
        {
            "key": "Flower",
            "value": "rose"
        },
        {
            "key": "Food",
            "value": "pie"
        }
    ]
}

Sample request for deleting tags in batches

POST /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/7d85f602-a948-4a30-afd4-e84f47471c15/tags/action
{
    "action": "delete",
    "tags": [
        {
            "key": "Flower",
            "value": "rose"
         },
        {
            "key": "Food",
            "value": "pie"
        }
    ]
}

Response Message