- API Reference
- API Description
- Tag Management
- Adding Resource Tags in Batches
Adding Resource Tags in Batches¶
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
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID. |
stream_id | Yes | String | Stream ID. |
Request Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-Token | Yes | String | User token The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
action | Yes | String | Operation to be performed. The value can only be create, which indicates batch creation. Enumeration values:
|
tags | Yes | Array of Tag objects | Tag list. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
key | No | String | Key
Minimum: 1 Maximum: 36 |
value | No | String | Value
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.