ListTagResources - 查询标签列表 - 密钥管理服务

查询密钥或凭据的标签。

接口说明

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	object
TagResource	array<object>	资源的标签列表。
	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。

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

变更历史

更多信息，参考变更详情。