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

查询密钥对标签 - ListKeypairTags

查询密钥对标签

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

GET /v3/{project_id}/keypairs/{resource_id}/tags

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

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

状态码：200

表3 响应Body参数
参数	参数类型	描述
tags	Array of TagItem objects	参数解释：标签列表，没有标签，数组默认为空参数解释：不涉及
sys_tags	Array of TagItem objects	参数解释：系统标签列表，没有标签，数组默认为空取值范围：不涉及

表4 TagItem
参数	参数类型	描述
key	String	参数解释：标签的名称取值范围：取值范围为1到128个字符，满足正则匹配"^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}_.:=+\-@]*)(?<!\s)$"
value	String	参数解释：标签的值取值范围：取值范围不超过255个字符，满足正则匹配"^([\p{L}\p{Z}\p{N}_.:\/=+\-@]*)$"

无

状态码：200

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ],
  "sys_tags" : null
}

请参见错误码。