更新时间:2024-08-07 GMT+08:00

查询所有标签

功能介绍

查询租户在指定Region下的所有标签集合 。

接口约束

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1.1/{project_id}/clusters/tags
表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目编号。获取方法,请参见获取项目ID

约束限制:

不涉及

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及

请求参数

无。

响应参数

状态码: 200

表2 响应参数说明

参数名

参数类型

说明

tags

Array of TagWithMultiValue objects

参数解释:

标签列表,请参见表3

表3 tags参数说明

参数

参数类型

描述

key

String

参数解释:

标签的键。

约束限制:

不涉及

取值范围:

标签的key值可以包含任意语种字母、数字、空格和_.:=+-@,但首尾不能含有空格,不能以_sys_开头。

默认取值:

不涉及

values

Array of strings

参数解释:

标签的值。

约束限制:

标签的value值可以包含任意语种字母、数字、空格和_.:=+-@,但首尾不能含有空格,不能以_sys_开头。

请求示例

查询所有标签请求示例

GET https://{endpoint}/v1.1/{project_id}/clusters/tags

响应示例

状态码: 200

操作成功。

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ]
}

状态码

状态码请参见状态码

错误码

请参见错误码