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.

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"
        }
    ]
}