更新时间:2024-03-13 GMT+08:00
分享

批量添加或删除标签

功能介绍

为指定实例批量添加标签,或批量删除标签。

该接口当前仅在华北-北京四区域开放。

URI

POST /v1.0/{project_id}/dcs/{instance_id}/tags/action

参数

是否必选

参数类型

描述

project_id

String

项目ID。

instance_id

String

实例ID。

URI示例:

Post https://{dcs_endpoint}/v1.0/{project_id}/dcs/{instance_id}/tags/action

请求参数

请求参数

表1 请求参数

参数

是否必选

参数类型

描述

action

String

操作标识:仅限于create(创建)、delete(删除)。

tags

Array of objects

标签列表。具体参数,请参考表2

表2 tags参数说明

参数

是否必选

参数类型

描述

key

String

标签键。

  • 不能为空。
  • 对于同一资源键值唯一。
  • 长度不超过36个字符。

value

String

标签值。

  • action为create时,必选。action为delete时,非必选。
  • 长度不超过43个字符。

请求实例

{
    "action": "create",
    "tags": [
        {
            "key": "dcs001",
            "value": "002"
        },
        {
            "key": "dcs003",
            "value": "004"
        }
]
}

响应参数

返回值

返回值

描述

200

创建/删除标签成功。

错误码

相关文档