调用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
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 of TagResource

由资源及其标签组成的集合，包含了资源ID、资源类型和标签键值等信息。
TagResource
ResourceId String asg-bp17xb4x1vr29lgt****

资源ID。
ResourceType String ALIYUN::ESS::SCALINGGROUP

资源类型。
TagKey String TestKey

标签键。
TagValue String TestValue

标签值。

示例

请求示例

https://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"
			}
		]
	}
}

错误码

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