ListTagResources - 查询资源标签

查询指定资源绑定的标签。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ResourceTypestring

资源类型,取值:

  • loadbalancer:网关型负载均衡实例。
  • listener:监听。
  • servergroup:服务器组。
loadbalancer
ResourceIdarray

资源 ID 列表。一次调用最多支持添加 50 个资源 ID。

ResourceIdstring

资源 ID。

gwlb-nrnrxwd15en27r****
Tagarray<object>

标签列表。一次调用最多支持 20 个标签。

TagModelobject

标签。

Keystring

标签键。

testKey
Valuestring

标签值。

testValue
NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 如果 NextToken 为空表示没有下一次查询。
  • 如果 NextToken 有返回值,该取值表示下一次查询开始的令牌。
WyI2NDQ3MWUxM2EzOWNhMmY0Y2M2YTRiNzZhOWQwNmU1Y2RlNTYzMGEzIiwibiIsIm4iLDEsLTEsMTY5ODcxMzI2NjU0MywiNjU0MDRlYjI2MmI3MDhjY2JiMjM0ZmU0ODNkNTVmMGRhZDllOTBi****
MaxResultsinteger

使用 NextToken 方式查询时,每次最多返回的结果数。取值范围:1~1000。默认值:20。

20

返回参数

名称类型描述示例值
object

请求的返回值。

NextTokenstring

是否拥有下一次查询的令牌(Token)。取值:

  • 如果 NextToken 为空表示没有下一次查询。
  • 如果 NextToken 有返回值,该取值表示下一次查询开始的令牌。
d209f4e63ec942c967c50c888a13****
RequestIdstring

请求 ID。

A95325A2-E421-58A6-88AD-7A26CE610F45
TagResourcesarray<object>

标签资源列表。

tagResourceobject

资源绑定的标签信息。

ResourceIdstring

资源 ID。

gwlb-nrnrxwd15en27r****
ResourceTypestring

资源类型,取值:

  • loadbalancer:网关型负载均衡实例。
  • listener:监听。
  • servergroup:服务器组。
loadbalancer
TagKeystring

标签键。

testKey
TagValuestring

标签值。

testValue

示例

正常返回示例

JSON格式

{
  "NextToken": "d209f4e63ec942c967c50c888a13****",
  "RequestId": "A95325A2-E421-58A6-88AD-7A26CE610F45",
  "TagResources": [
    {
      "ResourceId": "gwlb-nrnrxwd15en27r****\n",
      "ResourceType": "loadbalancer",
      "TagKey": "testKey",
      "TagValue": "testValue"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400MissingParam.TagsOrResourceIdsThe param of TagsOrResourceIds is missing.标签列表与资源ID列表全部未设置或为空列表
400MissingParam.TagKeyThe param of TagKey is missing.标签键参数缺失
400DuplicatedParam.ResourceIdThe param of %s is duplicated.参数%s重复
400DuplicatedParam.TagKeyThe param of %s is duplicated.标签键参数重复

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