调用ListTagResources查询云资源已经绑定的标签列表。

API描述

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

调试

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

请求参数

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

要执行的操作,取值:ListTagResources

RegionId String cn-hangzhou

资源所属的地域ID。

ResourceType String VPC

资源类型,取值:

  • VPC:专有网络。
  • VSWITCH:交换机。
  • ROUTETABLE:路由表。
  • EIP:弹性公网IP。
  • VpnGateWay:VPN网关实例。
ResourceId.N RepeatList vpc-bp16qjewdsunr41m1****

资源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://

NextToken String caeba0bbb2be03f84eb48b699f0a4883

查询凭证(Token),取值为上一次API调用返回的NextToken参数值。如果没有下一个查询,请不传。

MaxResults Integer 50

分页大小,取值范围:20~100,默认为50

返回数据

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

下一个查询开始Token,NextToken为空说明没有下一个。

RequestId String DE65F6B7-7566-4802-9007-96F2494AC512

请求ID。

TagResources Array of TagResource

绑定标签的资源信息。

TagResource
ResourceId String vpc-bp16qjewdsunr41m1****

资源ID。

ResourceType String VPC

资源类型。

TagKey String FinanceDept

标签键。

TagValue String FinanceJoshua

标签值。

示例

请求示例

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

正常返回示例

XML 格式

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

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. 您没有权限操作指定资源,请提交工单咨询。

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