Function

This API is used to add resource tags (such as stream tags) in batches. The API is idempotent. When you are creating tags, if there are duplicate keys in the request body, an error is reported. During tag creation, duplicate keys are not allowed. If a key exists in the database, its value will be overwritten.

URI

POST /v2/{project_id}/stream/{stream_id}/tags/action

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
stream_id	Yes	String	Stream ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. The token can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Operation to be performed. The value can be create only. create: batch creation Enumeration values: create
tags	Yes	Array of Tag objects	Tag list.

**Table 4** Tag
Parameter	Mandatory	Type	Description
key	No	String	Key. This field cannot be left blank. The key value of a resource must be unique. Character set: A-Z, a-z, 0-9, '-', '_', and Unicode characters (\u4E00-\u9FFF). Minimum: 1 Maximum: 36
value	No	String	Value. The value contains a maximum of 43 characters. Character set: A-Z, a-z, 0-9, '. ', '-', '_', and Unicode characters (\u4E00-\u9FFF). The value can contain only digits, letters, hyphens (-), and underscores (_). Minimum: 0 Maximum: 43

Response Parameters

None

Example Requests

Adding Resource Tags in Batches

POST https://{Endpoint}/v2/{project_id}/stream/{stream_id}/tags/action

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

Example Responses

None

Status Codes

Status Code	Description
204	Normal response.

Error Codes

See Error Codes.