ListTagResources_标签_API参考_负载均衡-阿里云

请求中至少指定参数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个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。
Tag.N.Value	String	否	FinanceJoshua	资源的标签值。N的取值范围：1~20。一旦传入该值，不可以为空字符串。最多支持128个字符，不能以`aliyun`和`acs:`开头，不能包含`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"
}

错误码

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