You need to enable JavaScript to run this app.
文档中心
负载均衡

负载均衡

复制全文
下载 pdf
标签
ListTagsForNLBResources - 查询满足指定条件的标签信息
复制全文
下载 pdf
ListTagsForNLBResources - 查询满足指定条件的标签信息
调用 ListTagsForNLBResources 接口,查询满足指定条件的标签信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:ListTagsForNLBResources​
要执行的操作,取值为 ListTagsForNLBResources。​
​
Version String 必选 示例值:2020-04-01​
API版本信息,当前版本为 2020-04-01。​
​
ResourceType String 必选 示例值:nlb​
资源的类型。取值如下:​
  • nlb:NLB实例。​
  • nlb_listener:监听器。​
  • nlb_servergroup:服务器组。​
  • nlb_security_policy:TLS自定义安全策略。​
​
ResourceIds.N String 可选 示例值:nlb-273sdsdswrfdp8u2j****​
资源的ID。​
  • 参数 - N:表示资源 ID的序号,取值范围 1~20。​
  • 多个资源 ID之间使用&分隔。​
说明​
​
TagType String 可选 示例值:custom​
标签类型。取值如下:​
  • custom:用户标签。​
  • system:系统标签。​
​
TagFilters.N.Key String 可选 示例值:k1​
根据标签查询资源时指定的标签键。​
  • N:表示标签键的序号,取值范围1~10。多个标签键之间使用&分隔。​
  • 指定多个标签键时,表示查询同时包含所有指定标签键的资源。​
说明​
传入的TagFilters.N.Key不存在时,返回为空字符串。​
​
TagFilters.N.Values.N String 可选 示例值:v1​
资源标签的标签值。​
  • 第一个N:表示标签键的序号,取值范围 1~10。​
  • 第二个N:表示标签值的序号,取值范围 1~3。同一标签键多个标签值之间的关系为逻辑“或(OR)”,即查询同一标签键下添加其中一个标签值的资源。​
  • 多个标签值之间使用&分隔。​
说明​
  • 如果传入该参数,则必须先传入TagFilters.N.Key。​
  • 该参数传入空值时,表示查询指定标签键下标签值为空的资源。​
​
NextToken String 可选 示例值:caeba0bbb2be03f84eb48b699f0a****​
分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的NextToken参数值。​
​
MaxResults Integer 可选 示例值:50​
单次查询的数量,默认为 10,最大为100。​
​
​
​
返回参数​
RequestId String 示例值:2024062415303301022514515207C4****​
请求ID。​
​
NextToken String 示例值:caeba0bbb2be03f84eb48b699f0a****​
本次调用返回的查询凭证值,返回为空表示没有下一页。​
​
ResourceTags Object[] 示例值:--​
资源及其附加的标签信息。​
ResourceType String 示例值:nlb​
资源的类型。​
​
ResourceId String 示例值:nlb-rrq1hytw2u4gv0x58c31xxx​
资源的ID。​
​
TagKey String 示例值:key​
资源附加标签的标签键。​
​
TagValue String 示例值:value​
资源附加标签的标签值。​
​
​
​
​
请求示例​
​
GET /?Action=ListTagsForNLBResources&Version=2020-04-01&ResourceType=nlb&ResourceIds.1=nlb-273sdsdswrfdp8u2j****&TagType=custom&TagFilters.1.Key=k1&TagFilters.1.Values.1=v1&NextToken=caeba0bbb2be03f84eb48b699f0a****&MaxResults=50 HTTP/1.1​
Host: clb.cn-beijing.volcengineapi.com​
Date: 20260310T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/clb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "ListTagsForNLBResources",​
"Version": "2020-04-01",​
"Service": "clb",​
"Region": "cn-beijing"​
},​
"Result": {​
"NextToken": "caeba0bbb2be03f84eb48b699f0a****",​
"RequestId": "2024062415303301022514515207C4****",​
"ResourceTags": [​
{​
"TagKey": "key",​
"TagValue": "value",​
"ResourceId": "nlb-rrq1hytw2u4gv0x58c31xxx",​
"ResourceType": "nlb"​
}​
]​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidIncorrectOrder.Malformed​
The specified index order is malformed.​
指定的索引顺序参数格式不合法。​
400​
InvalidMaxResult.Malformed​
The specified MaxResult is malformed.​
指定的 MaxResult 参数格式不合法。​
400​
InvalidMaxResults.Malformed​
The specified MaxResults is malformed.​
指定的 MaxResults 参数格式不合法。​
400​
InvalidNextToken.Malformed​
The specified NextToken is malformed.​
指定的 NextToken 参数格式不合法。​
400​
InvalidResourceType.Malformed​
The specified ResourceType is malformed.​
指定的 ResourceType 参数格式不合法。​
400​
InvalidTagKey.Malformed​
The specified TagKey is malformed.​
指定的 TagKey 参数格式不合法。​
400​
InvalidTagType.Malformed​
The specified TagType is malformed.​
指定的 TagType 参数格式不合法。​
400​
InvalidTagValue.Malformed​
The specified TagValue is malformed.​
指定的 TagValue 参数格式不合法。​
400​
LimitExceeded.Resource​
You've reached the limit on the number of resources that you can operate at a time.​
已达到单次可操作资源数量的上限。​
400​
LimitExceeded.TagFilterKey​
You've reached the limit on the number of tag keys that you can filter.​
已达到单次可指定过滤标签键数量的上限。​
400​
LimitExceeded.TagFilterValues​
You've reached the limit on the number of tag values that you can filter.​
已达到单次可指定过滤标签键值数量的上限。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'ResourceType'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 ResourceType。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the ''.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 。​
404​
InvalidResource.NotFound​
The specified resource does not exist.​
指定的资源不存在。​
500​
InternalError​
An internal error has occurred.​
发生内部错误。​
​
​
最近更新时间:2026.03.11 14:59:13
这个页面对您有帮助吗?
有用
有用
无用
无用