文档首页/分布式缓存服务 DCS/API参考 (联盟区域) /历史API（V1）/标签管理/批量添加或删除标签
更新时间：2025-12-29 GMT+08:00
查看PDF
分享

批量添加或删除标签

功能介绍

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

URI

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

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方式，参考获取项目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

创建/删除标签成功。

错误码

无

父主题：标签管理