全部產品
Search
文件中心

:ListTagResources

更新時間:Jan 23, 2025

查詢密鑰或憑據的標籤。

調試

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

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