更新时间：2026-08-18 GMT+08:00

查询项目标签 - ListProjectKeypairTags

查询用户在指定项目下的所有密钥对标签集合

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

GET /v3/{project_id}/keypairs/tags

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。可参考获取项目ID获取。约束限制：不涉及取值范围：以IAM服务接口返回值为准，字符长度32-32 默认取值：不涉及

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	参数解释：查询记录数约束限制： limit必须为整数取值范围： 1~1000 默认取值：默认为“1000”
offset	否	Integer	参数解释：索引位置。从offset指定的下一条数据开始查询。查询第一页数据时，将查询前一页数据时响应体中的值带入此参数约束限制： offset必须为整数取值范围：不涉及默认取值： offset默认为“0”

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）约束限制：不涉及取值范围： IAM服务查询用户Token接口为准默认取值：不涉及

状态码：200

表4 响应Body参数
参数	参数类型	描述
tags	Array of TagResponse objects	参数解释：标签列表，key和value键值对的集合 - key：表示标签键，一个密钥对下最多包含20个key，key不能为空，不能重复，同一个key中value不能重复。key最大长度为128个字符 - value：表示标签值。每个值最大长度255个字符，value之间为“与”的关系取值范围：不涉及
total_count	Integer	参数解释：标签列表数量取值范围：不涉及

表5 TagResponse
参数	参数类型	描述
key	String	参数解释：键取值范围：不涉及
values	Array of strings	参数解释：标签值集合取值范围：不涉及

无

状态码：200

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "val1" ]
  }, {
    "key" : "key2",
    "values" : [ "val2" ]
  } ]
}

请参见错误码。