Deleting Tags from a BMS

Function

This API is used to delete tags from a specified BMS in batches.
TMS uses this API to manage BMS tags.

This is an idempotent API. When you delete a tag but the tag does not exist, a successful result will be returned.

Restrictions and Limitations

A BMS can have a maximum of 20 tags.

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:batchDeleteBaremetalServerTags	write	instance*	g:RequestTag/<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, delete indicates the deletion 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.
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

Deleting two tags (key1: value1, key2:value3) from a BMS

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