更新时间:2024-04-16 GMT+08:00

创建删除预定义标签

功能介绍

用于创建或删除预定义标签。用户创建预定义标签后,可以使用预定义标签来给资源创建标签。

该接口支持幂等特性和处理批量数据。

幂等操作是指以相同参数调用同一个接口多次,对系统内部产生的影响是一致的。

URI

POST /v1.0/predefine_tags/action

请求消息

  • 要素说明
    表1 请求样例的要素说明

    名称

    是否必选

    参数类型

    说明

    action

    String

    操作标识(区分大小写):create(创建)、delete(删除)。

    tags

    Array of objects

    标签列表。数量在1到50之间。

    详细参数请参见表2

  • tags 字段数据结构说明
    表2 tags 字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    key

    String

    键。

    最大长度36个字符。字符集:A-Z,a-z,0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

    value

    String

    值。

    每个值最大长度43个字符,可以为空字符串。 字符集:A-Z,a-z,0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

  • 请求样例
    POST https://{TMS的Endpoint}/v1.0/predefine_tags/action
    {
        "action": "create",
        "tags": [
            {
                "key": "ENV1",
                "value": "DEV1"
            },
            {
                "key": "ENV2",
                "value": "DEV2"
            }
        ]
    }

响应示例

状态码: 200

操作成功

状态码

请参考状态码

错误码

请参考错误码