文档首页/ VPC终端节点 VPCEP/ API参考(吉隆坡区域)/ API/ TAG功能/ 批量添加或删除资源标签接口
更新时间:2022-08-15 GMT+08:00

批量添加或删除资源标签接口

功能介绍

为指定Endpoint Service或Endpoint批量添加或删除标签。

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

URI

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

参数说明如表1所示。

表1 参数说明

名称

是否必选

参数类型

描述

project_id

String

项目ID。

resource_type

String

资源类型,值为:endpoint_service或endpoint。

resource_id

String

资源ID,Endpoint Service ID或Endpoint ID。

请求消息

  • 参数说明
    表2 请求参数

    名称

    是否必选

    参数类型

    描述

    tags

    List<resource_tag>

    标签列表。

    租户权限时该字段必选。

    action

    String

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

    表3 resource_tag字段数据结构说明

    名称

    是否必选

    参数类型

    描述

    key

    String

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

    key需要满足标签字符集规范

    value

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

    String

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

    value需要满足标签字符集规范

  • 请求样例

    POST https://127.0.0.1:7443/v1/{project_id}/endpoint_service/{resource_id}/tags/action

    或https://127.0.0.1:7443/v1/{project_id}/endpoint/{resource_id}/tags/action

    POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action
    {
        "action": "create",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key",
                "value": "value3"
            }
    ]
    }
    {
        "action": "delete",
        "tags": [
            {
                "key": "key1"
             },
            {
                "key": "key2",
                "value": "value3"
            }
    ]
    }

响应消息

状态码

状态码请参见状态码