调用ListTagResources接口查询资源绑定的标签键和标签值信息。

调试

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

请求参数

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

要执行的操作。

取值:ListTagResources

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
MaxResults Integer 20

分批次查询时每次显示的条目数。取值范围:1~100。默认值:20

ResourceType String loadbalancer

资源类型,取值:

  • acl:访问控制。
  • loadbalancer:应用型负载均衡实例。
  • securitypolicy:安全策略。
  • servergroup:服务器组。
ResourceId Array of String d-2ze1ot4ah7xjyv0d****

资源ID。

Tag Array

标签。

Key String env

标签键。最多支持128个字符,不能以aliyunacs:开头,不能包含http://https://

Value String product

标签值。最多支持128个字符,不能以aliyunacs:开头,不能包含http://https://

返回数据

名称 类型 示例值 描述
MaxResults Integer 20

分批次查询时每次显示的条目数。

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
RequestId String 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3

请求ID。

TagResources Array of TagResource

返回符合标签键和标签值的标签。

ResourceId String d-2ze1ot4ah7xjyv0d****

资源ID。

ResourceType String loadbalancer

资源类型,取值:

  • acl:访问控制。
  • loadbalancer:应用型负载均衡实例。
  • securitypolicy:安全策略。
  • servergroup:服务器组。
TagKey String env

标签键。

TagValue String product

标签值。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTagResources
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=20
&ResourceType=loadbalancer
&ResourceId=["d-2ze1ot4ah7xjyv0d****"]
&Tag=[{"Key":"env","Value":"product"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
    <MaxResults>20</MaxResults>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3</RequestId>
    <TagResources>
        <ResourceId>d-2ze1ot4ah7xjyv0d****</ResourceId>
        <ResourceType>loadbalancer</ResourceType>
        <TagKey>env</TagKey>
        <TagValue>product</TagValue>
    </TagResources>
</ListTagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "MaxResults" : 20,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3",
  "TagResources" : [ {
    "ResourceId" : "d-2ze1ot4ah7xjyv0d****",
    "ResourceType" : "loadbalancer",
    "TagKey" : "env",
    "TagValue" : "product"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
404 ResourceNotFound.Acl The specified resource %s is not found. 资源%s不存在。
404 ResourceNotFound.LoadBalancer The specified resource %s is not found. 资源%s不存在。
404 ResourceNotFound.SecurityPolicy The specified resource %s is not found. 资源%s不存在。
404 ResourceNotFound.ServerGroup The specified resource %s is not found. 资源%s不存在。

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