Adding Tags for a BMS

Function

This API is used to add tags for a specified BMS in batches.
The Tag Management Service (TMS) uses this API to manage BMS tags.

This is an idempotent API. If a tag being created already exists (it has the same key and value as an existing tag), a successful result will be returned. A new tag will overwrite the original one if their keys are the same but values are different.

Constraints

A maximum of 20 tags can be added for a BMS.

Debugging

You can debug this API in API Explorer.

Authorization Information

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.

If you are using identity policy-based authorization, the permission listed below is required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
bms:servers:batchCreateBaremetalServerTags	write	instance*	g:ResourceTag/<tag-key> g:TagKeys g:EnterpriseProjectId	bms:servers:put	-

URI

POST /v1/{project_id}/baremetalservers/{server_id}/tags/action

Table 1 lists the parameters.

**Table 1** Parameter description
Parameter	Type	Mandatory	Description
project_id	String	Yes	Specifies the project ID.
server_id	String	Yes	Specifies the BMS ID.

Request Parameters

Parameter	Type	Mandatory	Description
tags	List <resource_tag>	Yes	Specifies the tag list. For details, see Table 2.
action	String	Yes	Specifies the operation (only lowercase letters are supported). For example, create indicates the creation operation.

**Table 2** **tags** data structure
Parameter	Type	Mandatory	Description
key	String	Yes	Specifies the tag key. It contains a maximum of 36 Unicode characters and cannot be empty. It cannot contain ASCII characters (0–31) or special characters =*<>\,\|/ The tag key of a BMS must be unique.
value	String	No	Specifies the tag value. Each value contains a maximum of 43 Unicode characters and can be an empty string. It cannot contain ASCII characters (0–31) or special characters =*<>\,\|/

Example Request

Adding two tags (key1: value1, key2:value3) for a BMS

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