查询密钥或凭据的标签。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListTagResources

要执行的操作。取值：ListTagResources。
RegionId String 是 cn-hangzhou

资源所属的地域ID。

说明 您可以调用DescribeRegions查看当前阿里云账号的可用地域列表。
NextToken String 否 caeba0bbb2be03f84eb48b699f0a4883

下一个查询开始的Token。

说明 如果一次调用只返回了部分被查询到的结果条目数（默认每次返回200行数据），则会同步返回NextToken参数值。您可以再次调用该接口，设置上次调用该接口返回的NextToken参数值，以实现分页查询。
ResourceType String 是 key

要查询标签的资源类型。取值：

  • key：密钥
  • secret：凭据
ResourceId.N String 否 key-hzz62f1cb66fa42qo****

要查询标签的资源ID列表，最多可以输入50个资源ID。

输入多个资源ID时，格式为["ResourceId.1","ResourceId.2",...]。
Tag.N.Key String 否 disk-encryption

标签键。每个标签由一个键值对（Key:Value）组成，包含标签键（Key）、标签值（Value）。

最多可以输入20个标签。输入多个标签时，格式为[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]。

说明 标签键不能以aliyun和acs:开头。
Tag.N.Value String 否 true

标签值。每个标签由一个键值对（Key:Value）组成，包含标签键（Key）、标签值（Value）。

最多可以输入20个标签。输入多个标签时，格式为[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]。

返回数据

名称 类型 示例值 描述
NextToken String e71d8a535bd9cc11

本次调用返回的Token，根据取值判断是否具备下一个查询开始的Token。

  • 如果NextToken为空，即"NextToken": ""，表示没有下一个。
  • 如果NextToken有值，则该值就是下一个查询开始的Token。
RequestId String 00827261-20B7-4562-83F2-4DF39876A45A

本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。
TagResources Array of TagResource

资源的标签列表。
TagResource
ResourceType String key

资源类型。
TagValue String true

标签值。
ResourceId String key-hzz62f1cb66fa42qo****

资源ID。
TagKey String disk-encryption

标签键。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTagResources
&RegionId=cn-hangzhou
&NextToken=caeba0bbb2be03f84eb48b699f0a4883
&ResourceType=key
&ResourceId=["key-hzz62f1cb66fa42qo****"]
&Tag=[{"Key":"disk-encryption","Value":"true"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
    <NextToken>e71d8a535bd9cc11</NextToken>
    <RequestId>00827261-20B7-4562-83F2-4DF39876A45A</RequestId>
    <TagResources>
        <ResourceType>key</ResourceType>
        <TagValue>true</TagValue>
        <ResourceId>key-hzz62f1cb66fa42qo****</ResourceId>
        <TagKey>disk-encryption</TagKey>
    </TagResources>
</ListTagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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

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