Performing Operations on a CBH Instance Tag

This API is used to perform operations on a CBH tag.

For details, see Calling APIs.

POST /v2/{project_id}/cbs/instance/{resource_id}/tags/action

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. To obtain the value, see Obtaining a Project ID.
resource_id	Yes	String	Resource ID. Obtain its value by calling the list API.

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain it by calling the IAM API for obtaining a user token. The token is the value of X-Subject-Token in the response header. For details, see Obtaining a User Token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Action. create delete
tags	Yes	Array of ResourceTag objects	Tag list. This parameter is mandatory when the tenant permission is used. For the op_service permission, choose either this field or sys_tags.
sys_tags	No	Array of ResourceTag objects	The system tag list. This field is only available to the op_service permission. Choose either this field or tags. _sys_enterprise_project_id is the only resource_tag structure key used in TMS calls. The value is UUID or 0. 0 indicates the default enterprise project. Only create is supported.

**Table 4** ResourceTag
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. The value can contain up to 128 characters.
value	Yes	String	Value. Each value can contain a maximum of 255 characters.

Status code: 204

A request has succeeded, but that the client does not need to navigate away from its current page.

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_description	String	Failed to verify the token.

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_description	String	Permissions required.

Status code: 404

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_description	String	Not CBH instances found.

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

None

Status Code	Description
204	A request has succeeded, but that the client does not need to navigate away from its current page.
400	Invalid parameters
401	Unauthorized
403	Forbidden
404	Not Found
500	System error.