调用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代码示例。

请求参数

名称 类型 是否必选 示例值 描述
ResourceType String 是 VPC

资源类型。取值：

  • VPC：专有网络实例。
  • VSWITCH：交换机实例。
  • ROUTETABLE：路由表实例。
  • EIP：弹性公网IP实例。
  • VpnGateWay：VPN网关实例。
  • NATGATEWAY：NAT网关实例。
  • COMMONBANDWIDTHPACKAGE：共享带宽实例。
RegionId String 是 cn-hangzhou

资源所属的地域ID。
NextToken String 否 caeba0bbb2be03f84eb48b699f0a4883

是否拥有下一次查询的令牌（Token）。取值：

  • 第一次查询和没有下一次查询时，均无需填写。
  • 如果有下一次查询，取值为上一次API调用返回的NextToken值。
Action String 是 ListTagResources

系统规定参数。取值：ListTagResources。

MaxResults Integer 否 50

分页大小，取值范围：1~50，默认值：50。

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://。

返回数据

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

是否拥有下一次查询的令牌（Token）。取值：

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
RequestId String DE65F6B7-7566-4802-9007-96F2494AC512

请求ID。
TagResources Array of TagResource

绑定标签的资源信息。
TagResource
ResourceType String VPC

资源类型。取值：

  • VPC：专有网络实例。
  • VSWITCH：交换机实例。
  • ROUTETABLE：路由表实例。
  • EIP：弹性公网IP实例。
  • VpnGateWay：VPN网关实例。
  • NATGATEWAY：NAT网关实例。
  • COMMONBANDWIDTHPACKAGE：共享带宽实例。
TagValue String FinanceJoshua

标签值。
ResourceId String vpc-bp16qjewdsunr41m1****

资源ID。
TagKey String FinanceDept

标签键。

示例

请求示例

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

正常返回示例

XML格式 

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

<ListTagResourcesResponse>
<TagResources>
    <TagResource>
        <ResourceType>VPC</ResourceType>
        <TagValue>aa</TagValue>
        <TagKey>aaa</TagKey>
        <ResourcId>vpc-wz9aml8mptq6fsnfm****</ResourcId>
    </TagResource>
</TagResources>
<NextToken/>
<RequestId>F11AC96F-B8E6-48F8-95CC-F63E7D50F0D4</RequestId>
</ListTagResourcesResponse>

JSON格式 

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

{
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "VPC",
      "TagValue" : "aa",
      "TagKey" : "aaa",
      "ResourcId" : "vpc-wz9aml8mptq6fsnfm****"
    } ]
  },
  "NextToken" : "",
  "RequestId" : "F11AC96F-B8E6-48F8-95CC-F63E7D50F0D4"
}

错误码

HttpCode 错误码 错误信息 描述
403 Forbidden User not authorized to operate on the specified resource. 您没有权限操作指定资源，请申请权限后再操作。

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