調用API ListTagResources查詢一個或多個彈性伸縮資源已經綁定的標簽列表,可以幫助您更好地分類和管理彈性伸縮資源,實現資源的自動化管理和權限控制等目標。
接口說明
- 請求參數中至少指定一個參數:
ResourceId.N
或者Tag.N
(即Tag.N.Key
與Tag.N.Value
),用以確定查詢對象。 - 如果同時指定參數
Tag.N
和ResourceId.N
時,返回結果中僅包含同時滿足這兩個條件的彈性伸縮資源。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ListTagResources | 系統規定參數。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou | 資源所屬的地域ID。您可以調用DescribeRegions查看最新的阿里云地域列表。 |
ResourceType | String | 是 | scalinggroup | 資源類型,目前僅支持伸縮組。取值:scalinggroup。 |
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a4883 | 下一個查詢開始的Token。 |
ResourceId.N | String | 否 | asg-bp17xb4x1vr29lgt**** | 資源ID,N的取值范圍:1~50。 |
Tag.N.Key | String | 否 | TestKey | 精確查找彈性伸縮資源時使用的標簽鍵。標簽鍵長度的取值范圍:1~128,N的取值范圍:1~20。
|
Tag.N.Value | String | 否 | TestValue | 精確查找彈性伸縮資源時使用的標簽值。可以為空字符串。最多支持128個字符,N的取值范圍:1~20。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
NextToken | String | caeba0bbb2be03f84eb48b699f0a4883 | 下一個查詢開始的Token。 |
RequestId | String | DE65F6B7-7566-4802-9007-96F2494A**** | 請求ID。 |
TagResources | Array of TagResource | 由資源及其標簽組成的集合,包含了資源ID、資源類型和標簽鍵值等信息。 |
|
TagResource | |||
TagValue | String | TestValue | 資源的標簽值。 |
ResourceType | String | ALIYUN::ESS::SCALINGGROUP | 資源類型。 |
ResourceId | String | asg-bp17xb4x1vr29lgt**** | 資源ID。 |
TagKey | String | TestKey | 資源的標簽鍵。 |
Propagate | Boolean | false | 標識該標簽是否為可傳播標簽。可能值:
|
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=scalinggroup
&NextToken=caeba0bbb2be03f84eb48b699f0a4883
&ResourceId=["asg-bp17xb4x1vr29lgt****"]
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTagResourcesResponse>
<NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
<RequestId>DE65F6B7-7566-4802-9007-96F2494A****</RequestId>
<TagResources>
<TagValue>TestValue</TagValue>
<ResourceType>ALIYUN::ESS::SCALINGGROUP</ResourceType>
<ResourceId>asg-bp17xb4x1vr29lgt****</ResourceId>
<TagKey>TestKey</TagKey>
<Propagate>false</Propagate>
</TagResources>
</ListTagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
"RequestId" : "DE65F6B7-7566-4802-9007-96F2494A****",
"TagResources" : [ {
"TagValue" : "TestValue",
"ResourceType" : "ALIYUN::ESS::SCALINGGROUP",
"ResourceId" : "asg-bp17xb4x1vr29lgt****",
"TagKey" : "TestKey",
"Propagate" : false
} ]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?