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

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
vpc:ListTagResources |
list |
*全部资源
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
ResourceType |
string |
是 |
资源类型。取值:PeerConnection,VPC 对等连接。 |
PeerConnection |
ResourceId
deprecated
|
array |
否 |
资源 ID。最多支持 20 个资源 ID。 |
|
string |
否 |
资源 ID。最多支持输入 20 个资源 ID。 说明
参数ResourceId.N或Tag.N(Tag.N.Key与Tag.N.Value)至少输入一个。 |
pcc-bp16qjewdsunr41m1**** |
|
Tag
deprecated
|
array<object> |
否 |
标签信息。 |
|
object |
否 |
资源的标签键。 |
||
Value |
string |
否 |
资源的标签值。最多支持 20 个标签值。一旦传入该值,可以为空字符串。 一个标签值最多支持 128 个字符,不能以 说明
参数ResourceId.N或Tag.N(Tag.N.Key与Tag.N.Value)至少输入一个。 |
FinanceJoshua |
Key |
string |
否 |
资源的标签键。最多支持 20 个标签键。一旦传入该值,则不允许为空字符串。 一个标签键最多支持 128 个字符,不能以 说明
参数ResourceId.N或Tag.N(Tag.N.Key与Tag.N.Value)至少输入一个。 |
FinanceDept |
MaxResults |
integer |
否 |
分批次查询时每次显示的条目数。取值范围:1~50,默认值:50。 |
50 |
NextToken |
string |
否 |
是否拥有下一次查询的令牌(Token)。取值:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
RegionId |
string |
是 |
资源所属的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
Category |
string |
否 |
标签类型。
|
All |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
请求 ID。 |
||
RequestId |
string |
请求 ID。 |
DE65F6B7-7566-4802-9007-96F2494AC512 |
TagResources |
array<object> |
绑定标签的资源信息。 |
|
object |
绑定标签的资源信息。 |
||
RegionNo |
string |
VPC 对等连接发起方的地域。 |
cn-hangzhou |
ResourceId |
string |
资源 ID。 |
pcc-bp16qjewdsunr41m1**** |
TagKey |
string |
标签键。 |
FinanceDept |
ResourceType |
string |
资源类型。取值:PeerConnection,VPC 对等连接。 |
PeerConnection |
TagValue |
string |
标签值。 |
FinanceJoshua |
NextToken |
string |
是否拥有下一次查询的令牌(Token)。取值:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
MaxResults |
integer |
分批次查询时每次显示的条目数。 |
50 |
示例
正常返回示例
JSON
格式
{
"RequestId": "DE65F6B7-7566-4802-9007-96F2494AC512",
"TagResources": [
{
"RegionNo": "cn-hangzhou",
"ResourceId": "pcc-bp16qjewdsunr41m1****",
"TagKey": "FinanceDept",
"ResourceType": "PeerConnection",
"TagValue": "FinanceJoshua"
}
],
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"MaxResults": 50
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidTagKey | The tag keys are not valid. | 无效的标签索引 |
400 | NumberExceed.Tags | The maximum number of tags is exceeded. | 标签数量超限 |
400 | NumberExceed.ResourceIds | The maximum number of resource IDs is exceeded. | 资源组ID数目超限 |
400 | Forbidden.TagKeys | The tag key cannot be operated by the request. | 该请求不允许操作此 tagkey |
400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | 标签资源重复 |
400 | InvalidInstanceIds.NotFound | The instance IDs are not found. | 实例ID没有找到 |
400 | InvalidInstanceType.NotFound | The instance type is not found. | 实例类型没有找到 |
400 | BothEmpty.TagsAndResources | The specified Tags and ResourcesIds are not allow to both empty. | 标签和资源信息不能同时为空。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。