ListTagResources - 查询标签列表_密钥管理服务(KMS)-阿里云帮助中心

查询密钥或凭据的标签。

接口说明

RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情，请参见访问控制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	资源所属的地域 ID。说明您可以调用 DescribeRegions 查看当前阿里云账号的可用地域列表。	cn-hangzhou
NextToken	string	否	下一个查询开始的 Token。说明如果一次调用只返回了部分被查询到的结果条目数（默认每次返回 200 行数据），则会同步返回 NextToken 参数值。您可以再次调用该接口，设置上次调用该接口返回的 NextToken 参数值，以实现分页查询。	caeba0bbb2be03f84eb48b699f0a4883
ResourceType	string	是	要查询标签的资源类型。取值： key：密钥 secret：凭据	key
ResourceId	array	否	要查询标签的资源 ID 列表，最多可以输入 50 个资源 ID。输入多个资源 ID 时，格式为`["ResourceId.1","ResourceId.2",...]`。
	string	否	要查询标签的资源 ID 列表，最多可以输入 50 个资源 ID。输入多个资源 ID 时，格式为`["ResourceId.1","ResourceId.2",...]`。	key-hzz62f1cb66fa42qo****
Tag	array<object>	否	要查询的标签列表。N 的取值范围 1~20。
	object	否	要查询的标签列表。N 的取值范围 1~20。
Key	string	否	标签键。每个标签由一个键值对（Key:Value）组成，包含标签键（Key）、标签值（Value）。最多可以输入 20 个标签。输入多个标签时，格式为`[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]`。说明标签键不能以 aliyun 和 acs:开头。	disk-encryption
Value	string	否	标签值。每个标签由一个键值对（Key:Value）组成，包含标签键（Key）、标签值（Value）。最多可以输入 20 个标签。输入多个标签时，格式为`[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]`。	true

返回参数

名称	类型	描述	示例值
	object
NextToken	string	本次调用返回的 Token，根据取值判断是否具备下一个查询开始的 Token。如果 NextToken 为空，即"NextToken": ""，表示没有下一个。如果 NextToken 有值，则该值就是下一个查询开始的 Token。	e71d8a535bd9cc11
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	00827261-20B7-4562-83F2-4DF39876A45A
TagResources	array<object>	资源的标签列表。
TagResource	object	资源的标签列表。
ResourceType	string	资源类型。	key
TagValue	string	标签值。	true
ResourceId	string	资源 ID。	key-hzz62f1cb66fa42qo****
TagKey	string	标签键。	disk-encryption

示例

正常返回示例

JSON格式

{
  "NextToken": "e71d8a535bd9cc11",
  "RequestId": "00827261-20B7-4562-83F2-4DF39876A45A",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "key",
        "TagValue": true,
        "ResourceId": "key-hzz62f1cb66fa42qo****",
        "TagKey": "disk-encryption"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	Duplicate.TagKey	The specified tagKey is duplicate.	指定的标签值是重复的。
404	InvalidAccessKeyId.NotFound	The Access Key ID provided does not exist in our records.	-
404	InvalidResourceId.NotFound	The specified ResourceId is not found.	没有找到指定的资源Id。

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-05-30	OpenAPI 错误码发生变更	查看变更详情