调用 ListTagsForResources 接口,查询满足指定条件的标签信息。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagsForResources | 要执行的操作,取值为ListTagsForResources。 |
Version | String | 是 | 2020-04-01 | API版本信息,当前版本为2020-04-01。 |
ResourceType | String | 是 | vpc | 资源的类型,取值如下:
|
ResourceIds.N | String | 否 | ResourceIds.1=vpc-273w3e33y2y9s7fap8u2j****&ResourceIds.2=vpc-bp15zckdt37pq72zv**** | 资源的ID。
|
TagType | String | 否 | custom | 标签类型,取值如下:
说明 该参数不传或传入为空时,查询全部类型的标签。 |
TagFilters.N.Key | String | 否 | TagFilters.1.Key=k1&TagFilters.2.Key=k2&TagFilters.3.Key=k3 | 标签的标签键。
|
TagFilters.N.Values.N | String | 否 | TagFilters.1.Values.1=v1&TagFilters.1.Values.2=v2&TagFilters.3.Values.1=v1 | 标签的标签值。
说明
|
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 | vpc | 资源的类型。 |
ResourceId | String | vpc-273w3e33y2y9s7fap8u2j**** | 资源的ID。 |
TagKey | String | k1 | 资源附加标签的标签键。 |
TagValue | String | v1 | 资源附加标签的标签值。 |
GET /?Action=ListTagsForResources&Version=2020-04-01&ResourceType=vpc&ResourceIds.1=vpc-273w3e33y2y9s7fap8u2j****&ResourceIds.2=vpc-bp15zckdt37pq72zv**** HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "ListTagsForResources", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****", "NextToken": "caeba0bbb2be03f84eb48b699f0a****", "ResourceTags": [ { "ResourceType": "vpc", "ResourceId": "vpc-273w3e33y2y9s7fap8u2j****", "TagKey": "k1", "TagValue": "v1" }, { "ResourceType": "vpc", "ResourceId": "vpc-bp15zckdt37pq72zv****", "TagKey": "k2", "TagValue": "v2" } ] } }
此处仅展示当前API的错误码,更多错误码请参见公共错误码。
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 | 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. | 指定的资源不存在。 |