调用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
} ]
}
错误码
访问错误中心查看更多错误码。