调用ListTagsForResources接口，查询满足指定条件的标签信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：ListTagsForResources

接口名称。当前 API 的名称为 ListTagsForResources。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

ResourceType String 必选示例值：directconnectconnection

查询标签的资源类型，取值如下：

directconnectconnection：物理专线

directconnectgateway：专线网关

directconnectvirtualinterface：虚拟接口

ResourceIds.N String 可选示例值：dcc-lhn2cx0an18****

目标资源的ID。

参数 - N：表示资源 ID的序号，单次调用数量上限50个。

多个资源 ID之间使用&分隔。

TagType String 可选示例值：custom

标签类型，取值如下：

custom：用户标签。

system：系统标签。

该参数不传或传入为空时，查询全部类型的标签。

TagFilters.N.Key String 可选示例值：k1

标签的标签键。

参数 - N：表示标签键的序号，取值范围：1～10。

多个标签键之间用&分隔。多个标签键之间的关系为逻辑“与（AND）”，即查询同时添加多个标签键的资源。

TagFilters.N.Values.M String 可选示例值：v1

标签的标签值。

第一个N：表示标签键的序号。

第二个N：表示标签值的序号，取值范围：1～3。同一标签键多个标签值之间的关系为逻辑“或(OR)”，即查询同一标签键下添加其中一个标签值的资源。

多个标签值之间用&分隔。

说明

若传入该参数，则必须先传入TagFilters.N.Key。

传入空字符串时，表示查询标签值为空的资源。

NextToken String 可选示例值：caeba0bbb2be03f84eb48b699f0a****

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

MaxResults Integer 可选示例值：50

单次查询的数量，默认为 10，最大为100。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

NextToken String 示例值：caeba0bbb2be03f84eb48b699f0a****

本次调用返回的查询凭证值，返回为空表示没有下一页。

ResourceTags Object[] 示例值：-

资源附加的标签信息。

TagKey String 示例值：key

资源附加标签的标签键。

TagValue String 示例值：value

资源附加标签的标签值。

ResourceId String 示例值：dcc-lhn2cx0an18****

资源的ID。

ResourceType String 示例值：directconnectconnection

资源的类型。

directconnectconnection：物理专线

directconnectgateway：专线网关

directconnectvirtualinterface：虚拟接口

请求示例

返回示例

错误码

公共错误码请参见公共错误码文档。

专线连接