调用ListTagResources查询一个或多个弹性伸缩资源已经绑定的标签列表。

接口说明

  • 请求中至少指定一个参数:ResourceId.N或者Tag.NTag.N.KeyTag.N.Value),以确定查询对象。
  • 同时指定参数Tag.NResourceId.N时,返回结果中仅包含同时满足这两个条件的弹性伸缩资源。

调试

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

请求参数

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

系统规定参数。取值:ListTagResources

RegionId String cn-hangzhou

资源所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

ResourceType String scalinggroup

资源类型,目前只支持伸缩组。取值:scalinggroup

ResourceId.N RepeatList asg-bp17xb4x1vr29lgt****

资源ID。N的取值范围:1~50

Tag.N.Key String TestKey

精确查找弹性伸缩资源时使用的标签键。标签键长度的取值范围:1~128。N的取值范围:1~20

Tag.N用于精确查找绑定了指定标签的弹性伸缩资源,由一个键值对组成。

  • 仅指定Tag.N.Key时,则返回关联该标签键的所有资源。
  • 仅指定Tag.N.Value,则报错MissingParameter.TagKey
  • 同时指定多个标签键值对时,仅同时满足所有标签键值对的弹性伸缩资源会被查找到。
Tag.N.Value String TestValue

精确查找弹性伸缩资源时使用的标签值。标签值长度的取值范围:1~128。N的取值范围:1~20

NextToken String caeba0bbb2be03f84eb48b699f0a4883

下一个查询开始的Token。

返回数据

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

下一个查询开始的Token。

RequestId String DE65F6B7-7566-4802-9007-96F2494AC5XX

请求ID。

TagResources Array

由资源及其标签组成的集合,包含了资源ID、资源类型和标签键值等信息。

TagResource
ResourceId String asg-bp17xb4x1vr29lgt****

资源ID。

ResourceType String ALIYUN::ESS::SCALINGGROUP

资源类型。

TagKey String TestKey

标签键。

TagValue String TestValue

标签值。

示例

请求示例

http://ess.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=scalinggroup
&ResourceId.1=asg-bp17xb4x1vr29lgt****
&<公共请求参数>

正常返回示例

XML 格式

<ListTagResourcesResponse>
      <RequestId>6E79F465-6101-4071-A852-19B76E238717</RequestId>
      <NextToken></NextToken>
      <TagResources>
            <TagResource>
                  <ResourceId>asg-bp17xb4x1vr29lgt****</ResourceId>
                  <TagKey>TestKey</TagKey>
                  <ResourceType>ALIYUN::ESS::SCALINGGROUP</ResourceType>
                  <TagValue>TestValue</TagValue>
            </TagResource>
      </TagResources> 
</ListTagResourcesResponse>

JSON 格式

{
	"RequestId": "6E79F465-6101-4071-A852-19B76E238717",
	"NextToken": "",
	"TagResources": {
		"TagResource": [
			{
				"ResourceId": "asg-bp17xb4x1vr29lgt****",
				"TagKey": "TestKey",
				"ResourceType": "ALIYUN::ESS::SCALINGGROUP",
				"TagValue": "TestValue"
			}
		]
	}
}

错误码

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