文档首页/ 云审计服务 CTS/ API参考/ API V3（推荐使用）/ 标签管理/ 查询项目标签列表
更新时间：2025-06-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询项目标签列表

功能介绍

查询项目标签列表

调用方法

请参见如何调用API。

URI

GET /v3/{project_id}/{resource_type}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

resource_type

是

String

资源的类型：cts-tracker
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

查询返回记录的数量限制。默认为200，limit最多为200,不能为负数，最小值为1

marker

否

String

分页参数，通过上一个请求中返回的marker信息作为输入，获取当前页。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

tags

Array of TmsTags objects

标签列表。

page_info

PageInfo object

分页参数。
表4 TmsTags

参数

参数类型

描述

key

String

键。最大长度128个unicode字符。标签的键可以包含任意语种字母、数字、空格和_ . : = + - @，但首尾不能含有空格

values

Array of strings

value列表
表5 PageInfo

参数

参数类型

描述

current_count

Integer

当前页Key数量。

next_marker

String

下一页marker。

请求示例

无

响应示例

状态码：200

请求成功。

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ],
  "page_info" : {
    "current_count" : "200",
    "next_marker" : "xxx"
  }
}

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码。

父主题： 标签管理