批量删除裸金属服务器标签 - BatchDeleteBaremetalServerTags

功能介绍

为指定裸金属服务器批量删除标签。
TMS使用该接口批量管理裸金属服务器的标签。

此接口为幂等接口，删除时，如果删除的标签不存在，默认处理成功。

约束与限制

每个裸金属服务器最多20个标签。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
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

参数说明请参见表1。

表1 参数说明
参数	参数类型	是否必选	描述
project_id	String	是	项目ID。
server_id	String	是	裸金属服务器ID。

请求参数

参数	参数类型	是否必选	描述
tags	List <resource_tag>	是	标签列表，详见表 tags字段数据结构说明。
action	String	是	操作标识（仅支持小写）：delete（删除）

表2 tags字段数据结构说明
参数	参数类型	是否必选	描述
key	String	是	键最大长度36个unicode字符，不能为空。
value	String	否	值每个值最大长度43个unicode字符，可以为空字符串。不能包含非打印字符ASCII（0-31），以及以下特殊字符：=*<>\,\|/

请求示例

批量删除标签，标签键值对为key1和value1，key2和value3。

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