调用ListTagResources查询实例已经绑定的标签列表。

  • 请求中至少指定参数ResourceId.N或Tag.N(Tag.N.Key与Tag.N.Value),以确定检索对象。
  • Tag.N是资源的标签,由一个键值对组成。仅指定Tag.N.Key时,则返回该标签键关联的所有标签值。仅指定Tag.N.Value会报错。
  • 如果您同时指定Tag.N和ResourceId.N筛选标签,则ResourceId.N必须满足所有输入的标签键值对。
  • 如果您同时指定多个标签键值对,返回结果为同时包含被指定的多个键值对的资源。

调试

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

请求参数

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

要执行的操作。

取值:ListTagResources

RegionId String cn-hangzhou

负载均衡实例所在的地域ID。

您可以通过调用DescribeRegions接口查询地域ID。

ResourceType String instance

资源类型定义,取值:

  • instance:负载均衡实例。
  • certificate:证书。
  • acl:访问控制。
NextToken String caeba0bbb2be03f84eb48b699f0a4883

下一个查询开始Token。

ResourceId.N RepeatList lb-bp1qnnvj18yy6h******

资源ID, N的取值范围为1~20。

Tag.N.Key String FinanceDept

资源的标签键。N的取值范围:1~20。

一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyunacs:开头,不能包含http://或者https://

Tag.N.Value String FinanceJoshua

资源的标签值。N的取值范围:1~20。一旦传入该值,不可以为空字符串。

最多支持128个字符,不能以aliyunacs:开头,不能包含http://或者https://

返回数据

名称 类型 示例值 描述
RequestId String DE65F6B7-7566-4802-9007-96F2494AC512

请求ID。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

下一个查询开始Token。

TagResources Array

绑定标签的资源信息。

TagResource

绑定标签的资源信息。

ResourceId String lb-bp16qjewdsunr4******

资源ID。

ResourceType String instance

资源类型。

TagKey String FinanceDept

标签键。

TagValue String FinanceJoshua

标签值。

示例

请求示例


http(s)://[Endpoint]/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=instance
&ResourceId.1=lb-bp16qjewdsunr41m1****
&<公共请求参数>

正常返回示例

XML 格式

<ListTagResourcesResponse>
  <TagResources>
        <TagResource>
              <ResourceType>instance</ResourceType>
              <TagValue>FinanceJoshua</TagValue>
              <ResourceId>lb-bp16qjewdsunr41m1****</ResourceId>
              <TagKey>FinanceDept</TagKey>
        </TagResource>
  </TagResources>
  <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
  <RequestId>DE65F6B7-7566-4802-9007-96F2494AC512</RequestId>
</ListTagResourcesResponse>

JSON 格式

{
	"TagResources":{
		"TagResource":[
			{
				"ResourceType":"instance",
				"TagValue":"FinanceJoshua",
				"ResourceId":"lb-bp16qjewdsunr41m1****",
				"TagKey":"FinanceDept"
			}
		]
	},
	"NextToken":"caeba0bbb2be03f84eb48b699f0a4883",
	"RequestId":"DE65F6B7-7566-4802-9007-96F2494AC512"
}

错误码

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