更新时间:2023-11-21 GMT+08:00

添加保护实例标签

功能介绍

一个保护实例上最多有10个标签。

此接口为幂等接口:

创建时,如果创建的标签已经存在(key相同),则覆盖。

URI

  • URI格式

    POST /v1/{project_id}/protected-instances/{protected_instance_id}/tags

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID。

    获取方法请参见获取项目ID

    protected_instance_id

    String

    保护实例的ID。

    具体参数请参考查询保护实例列表接口。

请求消息

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    tag

    Object

    需要添加的标签。

    详情请参见表1

    表1 tag字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    key

    String

    键。同一资源的key值不能重复。

    最大长度为36个UNICODE字符。key不能为空,不允许为空字符串。不能包含以下字符:非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”键。不能为空。对于同一资源键值唯一。

    value

    String

    值。

    最大长度为43个UNICODE字符。value不能为空,可以为空字符串。不能包含以下字符:非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”。

  • 请求样例
    POST https://{Endpoint}/v1/{project_id}/protected-instances/67a2cc7e-fb87-41a8-ba28-9c032abcaee1/tags
    {
        "tag": {
            "key": "DEV",
            "value": "DEV1"
        }
    }

响应

  • 响应样例

返回值

  • 正常

    返回值

    说明

    204

    No Content

  • 异常

    返回值

    说明

    400

    参数非法

    401

    鉴权失败

    403

    权限不足

    404

    资源未找到

    500

    系统异常