文档首页 > > API参考> API> 标签管理> 批量添加删除资源标签

批量添加删除资源标签

分享
更新时间: 2020/02/24 GMT+08:00

功能介绍

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

一个资源上最多有10个标签。

  • 此接口为幂等接口,创建时如果请求体中存在重复key则报错。
  • 创建时不允许设置重复key数据,如果数据库已存在该key,就覆盖value的值。
  • 删除时不对标签字符集范围做校验,如果删除的标签不存在,默认处理成功。删除时tags结构体不能缺失,key不能为空,或者空字符串。

URI

POST /{version}/{project_id}/{resource_type}/{resource_id}/tags/action

表1 Path参数

名称

参数类型

说明

version

String

API版本,取值必须为v2

project_id

String

项目ID

resource_type

String

资源类型

  • ief-edge_node
  • ief-deployment
  • ief-application
  • ief-app_version
  • ief-device
  • ief-configmap
  • ief-secret

resource_id

String

资源ID

请求消息

表2 Body参数

名称

是否必选

参数类型

说明

tags

Array of resource_tag objects

标签列表

action

String

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

表3 resource_tag

名称

是否必选

参数类型

说明

key

String

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

不能为空,只能包含大小写字母,数字,中划线“-”,下划线“_”。

value

(action为create时必选。action为delete时非必选)

String

值。每个值最大长度43个unicode字符,删除时如果value有值按照key/value删除,如果value没值,则按照key删除。

不能为空,只能包含大小写字母,数字,中划线“-”,下划线“_”。

请求样例

{
    "action": "create",
    "tags": [
        {
            "key": "key0",
            "value": "value1_new1"
        },
        {
            "key": "key1",
            "value": "value3_new"
        },
        {
            "key": "key2",
            "value": "value1_new1"
        },
        {
            "key": "key3",
            "value": "value3_new"
        },
        {
            "key": "key4",
            "value": "value1_new1"
        },
        {
            "key": "key5",
            "value": "value3_new"
        },
        {
            "key": "key6",
            "value": "value1_new1"
        },
        {
            "key": "key7",
            "value": "value3_new"
        },
        {
            "key": "key8",
            "value": ""
        }
    ]
}

响应消息

状态码

状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问