更新时间:2022-02-22 GMT+08:00

查询资源标签

功能介绍

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

接口约束

一个文档数据库实例具有10个标签配额,且标签key唯一。

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/tags

  • 参数说明
    表1 参数说明

    名称

    是否必选

    描述

    project_id

    租户在某一region下的project ID。

    instance_id

    实例ID。

请求消息

  • 请求头
    GET https://DDS的Endpoint/v3/{project_id}/instances/{instance_id}/tags
  • 请求体

    N/A

响应消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    描述

    tags

    Array of objects

    实例标签列表。详情请参见表3

    表3 tags字段数据结构说明

    名称

    是否必选

    参数类型

    描述

    key

    String

    标签键。最大长度36个unicode字符,key不能为空。

    字符集:0-9,A-Z,a-z,“_”,“-”。

    value

    String

    标签值。最大长度43个unicode字符,可以为空字符串。

    字符集:0-9,A-Z,a-z,“_”,“.”,“-”。

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

状态码

详情请参见状态码

错误码

详情请参见错误码