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

查询保护实例标签

功能介绍

查询指定保护实例的标签信息。

URI

  • URI格式

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

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID。

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

    protected_instance_id

    String

    保护实例的ID。

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

请求消息

  • 请求参数

  • 请求样例

    GET https://{Endpoint}/v1/{project_id}/protected-instances/50f5091e-9e9e-473c-a932-2a2cbcbeb1ff/tags

响应

  • 要素说明

    名称

    是否必选

    参数类型

    说明

    tags

    Array of objects

    标签列表。

    详情请参见表1

    表1 resource_tag字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    key

    String

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

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

    value

    String

    值。

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

  • 响应样例
    {
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value3"
            }
        ]
    }

返回值

  • 正常

    返回值

    说明

    200

    OK

  • 异常

    返回值

    说明

    400

    参数非法

    401

    鉴权失败

    403

    权限不足

    404

    资源未找到

    500

    系统异常