文档首页> 配置审计 Config> API参考> API> 资源标签> 批量添加资源标签
更新时间：2024-05-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量添加资源标签

功能介绍

此接口为幂等接口。为指定实例批量添加或删除标签，标签管理服务需要使用该接口批量管理实例的标签。一个资源上最多有20个标签。

调用方法

请参见如何调用API。

URI

POST /v1/resource-manager/{resource_type}/{resource_id}/tags/create

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

是

String

资源类型。

resource_id

是

String

资源ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

否

Array of ResourceTag objects

标签列表。

数组长度：1 - 20
表3 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

键。最大长度128个unicode字符。

最小长度：1

最大长度：128

value

是

String

值。每个值最大长度255个unicode字符。

最小长度：0

最大长度：255

响应参数

状态码： 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 404

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

请求示例

为指定实例批量添加标签

POST https://{endpoint}/v1/resource-manager/{resource_type}/{resource_id}/tags/create

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

响应示例

无

状态码

状态码

描述

204

DELETE操作正常返回。

400

输入参数不合法。

401

鉴权失败。

403

用户身份认证失败。

404

资源未找到。

500

服务器内部错误。

错误码

请参见错误码。

父主题： 资源标签
分享：

    相关文档

    相关产品