调用ListTagsForResources接口，查询满足指定条件的标签信息。 ## **调用说明** a.N.b类型的参数中，“N”表示根据标签查询资源时标签信息的序号，需按照数字顺序从1开始填写，取值范围为1～10。多个标签之间使用&分隔。 ## **请求参数** |名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |ListTagsForResources |要执行的操作，取值为ListTagsForResources。 | |Version |String |是 |2020\-04\-01 |API版本信息，当前版本为2020\-04\-01。 | |ResourceType |String |是 |ngw |绑定标签的资源类型，当前仅支持ngw，即NAT网关实例。 | |ResourceIds.N |String |否 |ResourceIds.1= ngw\-2feq5xhimd88w59gp686\*\*\*\* &ResourceIds.2= ngw\-2feq5xhimd88w59gp687\*\*\*\* |NAT网关的ID。|\ | | | | ||\ | | | | |* 参数 \- N：表示资源 ID的序号，单次调用数量上限50个。|\ | | | | |* 多个资源 ID之间使用&分隔。 | |TagType|String |否 |custom |标签类型，取值如下：|\ | | | | ||\ | | | | |* custom：用户标签。|\ | | | | |* system：系统标签。|\ | | | | ||\ | | | | |> 该参数不传或传入为空时，查询全部类型的标签。 | |TagFilters.N.Key|String |否 |TagFilters.1.Key=k1&TagFilters.2.Key=k2&TagFilters.3.Key=k3|标签的标签键。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签键的序号，取值范围：1～10。|\ | | | | |* 多个标签键之间用&分隔。多个标签键之间的关系为逻辑“与（AND）”，即查询同时添加多个标签键的资源。 | |TagFilters.N.Values.N|String |否|TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2&TagFilters.3.Values.1=v1|标签的标签值。|\ | | | | ||\ | | | | |* 第一个N：表示标签键的序号。|\ | | | | |* 第二个N：表示标签值的序号，取值范围：1～3。同一标签键多个标签值之间的关系为逻辑“或(OR)”，即查询同一标签键下添加其中一个标签值的资源。|\ | | | | |* 多个标签值之间用&分隔。|\ | | | | ||\ | | | | |> 说明|\ | | | | ||\ | | | | |> * 若传入该参数，则必须先传入TagFilters.N.Key。|\ | | | | |> * 传入空字符串时，表示查询标签值为空的资源。 | |NextToken|String |否 |caeba0bbb2be03f84eb48b699f0a\*\*\*\*|分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。 |\ | | | | | | |MaxResults |Integer |否 |50 |单次查询的数量，默认为 10，最大为100。 | ## **返回数据** |名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2021062415303301022514515207C4\*\*\*\* |请求ID。 | |NextToken |String |caeba0bbb2be03f84eb48b699f0a\*\*\*\* |本次调用返回的查询凭证值，返回为空表示没有下一页。 | |ResourceTags |Array of Struct |\- |资源附加的标签信息。具体参见下表“**ResourceTag”。** | **ResourceTag** |名称 |类型 |示例值 |描述 | |---|---|---|---| |ResourceType |String |ngw |资源的类型。 | |ResourceId |String |ngw\-2feq5xhimd88w59gp686\*\*\*\* |资源的ID。 | |TagKey |String |k1 |资源附加标签的标签键。 | |TagValue |String |v1 |资源附加标签的标签值。 | ## **请求示例** ```HTTP GET /?Action=ListTagsForResources&Version=2020-04-01&ResourceType=vpngateway&ResourceIds.1=vgw-273w3e33y2y9s7fap8u2j****&ResourceIds.2=vgw-bp15zckdt37pq72zv**** HTTP/1.1 Host: open.volcengineapi.com Service: vpn Region: cn-beijing ``` ## **返回示例** ```JSON { "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "ListTagsForResources", "Version": "2020-04-01", "Service": "vpn", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****", "NextToken": "caeba0bbb2be03f84eb48b699f0a****", "ResourceTags": [ { "ResourceType": "ngw", "ResourceId": "ngw-2feq5xhimd88w59gp686****", "TagKey": "k1", "TagValue": "v1" }, { "ResourceType": "ngw", "ResourceId": "ngw-2feq5xhimd88w59gp687****", "TagKey": "k2", "TagValue": "v2" } ] } } ``` ## **错误码** |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |LimitExceeded.Resource |You've reached the limit on the number of resources that you can operate at one time. |已达到单次可操作资源数量的上限。 | |400 |InvalidResourceType.Malformed |The specified parameter resource type is invalid. |资源类型不合法。 | |400 |InvalidResourceType.NotFound |The specified resource type does not exist. |指定的资源类型不存在。 | |400 |InvalidTagType.Malformed |The specified parameter tag type is invalid. |标签类型不合法。 | |400 |InvalidTagFilterKey.Malformed |The specified parameter tag filter key is invalid. |过滤标签键不合法。 | |400 |InvalidTagFilterValue.Malformed |The specified parameter tag filter value is invalid. |过滤标签值不合法。 | |400 |LimitExceeded.TagFilterKey |You've reached the limit on the number of tag keys that you can filter. |已达到单次可指定过滤标签键数量的上限。 | |400 |LimitExceeded.TagFilterValue |You've reached the limit on the number of tag values that you can filter. |已达到单次可指定过滤标签值数量的上限。 | |400 |InvalidNextToken.Malformed |The specified parameter NextToken is invalid. |查询NextToken不合法。 | |400 |InvalidMaxResults.Malformed |The specified parameter MaxResults is malformed. |查询数量不合法。 | |400 |InvalidTagFilter.Disorder |The specified index order of tag filter is malformed. |指定标签过滤项的索引顺序参数格式不合法。 | |404 |InvalidResource.NotFound |The specified resource does not exist. |指定的资源不存在。 |