查詢密鑰或憑據的標簽。

調試

您可以在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。

訪問錯誤中心查看更多錯誤碼。