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

负载均衡

复制全文
下载 pdf
标签
TagNLBResources - 为NLB资源添加用户标签
复制全文
下载 pdf
TagNLBResources - 为NLB资源添加用户标签
调用 TagNLBResources 接口,为NLB资源添加用户标签。​
使用说明​
每个资源最多可添加50个用户标签,每次调用该接口最多可添加20个用户标签。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:TagNLBResources​
要执行的操作,取值为 TagNLBResources。​
​
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之间使用&分隔。​
说明​
​
Tags.N.Key String 必选 示例值:key1​
用户标签的标签键。​
  • 参数 - N:表示标签键的序号,取值范围:1~20。​
  • 多个标签键之间用&分隔。​
  • 不能以 volc:或sys:开头,包括任意大小写形式。​
  • 长度取值范围为1~128字符,允许输入各国语言文字、数字、空格( )、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、中划线(-)和@(@)。​
  • 若标签键开头或结尾存在空格,系统会自动为其去除。​
说明​
同一资源的标签键不允许重复。​
​
Tags.N.Value String 可选 示例值:value1​
用户标签的标签值。​
  • 参数 - N:表示标签值的序号,取值范围:1~20。​
  • 多个标签值之间用&分隔。​
  • 长度取值范围为0~256字符,不填默认为空。​
  • 允许输入各国语言文字、数字、空格( )、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、中划线(-)和@(@)。​
  • 大小写敏感。​
  • 若标签值开头或结尾存在空格,系统会自动为其去除。​
说明​
若传入该参数,则必须先传入Tags.N.Key。​
​
​
​
返回参数​
RequestId String 示例值:2024062415303301022514515207C4****​
请求ID。​
​
​
​
请求示例​
​
GET /?Action=TagNLBResources&Version=2020-04-01&ResourceType=nlb&ResourceIds.1=nlb-273sdsdswrfdp8u2j****&Tags.1.Key=key1&Tags.1.Value=value1 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": "TagNLBResources",​
"Version": "2020-04-01",​
"Service": "clb",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "2024062415303301022514515207C4****"​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidIncorrectOrder.Malformed​
The specified index order is malformed.​
指定的索引顺序参数格式不合法。​
400​
InvalidResourceType.Malformed​
The specified ResourceType is malformed.​
指定的 ResourceType 参数格式不合法。​
400​
InvalidTagKey.Malformed​
The specified TagKey is malformed.​
指定的 TagKey 参数格式不合法。​
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.ServiceManagedTag​
You've reached the limit on the number of service managed tags that you can create.​
已达到单次可创建受管资源标签键值数量的上限。​
400​
LimitExceeded.TagOperation​
You've reached the limit on the number of tags that you can operate at a time.​
已达到单次可操作的标签条目数量上限。​
400​
QuotaExceeded.ResourceCustomTags​
You've reached the limit on the number of resource tags that you can create.​
已达到单个资源可创建用户标签的数量的配额上限。​
400​
QuotaExceeded.ResourceSystemTags​
You've reached the limit on the number of system tags that you can create.​
已达到单个资源可创建系统标签的数量的配额上限。​
403​
Forbidden​
You are not authorized to perform operations on the service managed tag.​
无权限对指定资源打上受管标签。​
403​
Forbidden​
You are not authorized to perform operations on the system tag.​
无权限对指定资源打上系统标签。​
403​
InvalidResourceType.ServiceManaged​
The specified ResourceType is managed by a service.​
指定的资源是服务托管资源。​
404​
InvalidResource.NotFound​
The specified resource does not exist.​
指定的资源不存在。​
500​
InternalErro​
An internal error has occurred.​
发生内部错误。​
​
​
最近更新时间:2026.03.11 14:59:13
这个页面对您有帮助吗?
有用
有用
无用
无用