Batch Adding or Deleting Tags

Function

This API is used to add or delete tags in batches for a DCS instance.

Calling Method

For details, see Calling APIs.

URI

POST /v2/{project_id}/dcs/{instance_id}/tags/action

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Operation to be performed. The value can be create or delete.
tags	Yes	Array of ResourceTag objects	Tag list.

**Table 3** ResourceTag
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. Must be unique for each resource. Contains up to 128 characters. Must be unique and cannot be empty.
value	No	String	Tag value. This parameter is mandatory when action is set to create and is optional when action is set to delete. It can contain a maximum of 255 characters.

Response Parameters

Status code: 204

Tags added or deleted successfully.

None

Example Requests

Adding tags to a specified resource in batches

POST https://{dcs_endpoint}/v2/7dddae81f0e34f62adb9618bc8c8b1fe/dcs/01928d55-7020-4500-9c29-774caabe4bc4/tags/action

{
  "action" : "create",
  "tags" : [ {
    "value" : "2",
    "key" : "dcs001"
  }, {
    "value" : "4",
    "key" : "dcs003"
  } ]
}

Deleting tags from a specified instance in batches

POST https://{dcs_endpoint}/v2/7dddae81f0e34f62adb9618bc8c8b1fe/dcs/01928d55-7020-4500-9c29-774caabe4bc4/tags/action

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