调用 TagNLBResources 接口，为NLB资源添加用户标签。 ## 使用说明每个资源最多可添加50个用户标签，每次调用该接口最多可添加20个用户标签。 ## 请求参数 |名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |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 |是 |ResourceIds.1=nlb\-273sdsdswrfdp8u2j\*\*\*\*&ResourceIds.2=nlb\-2fe6fszjgeznk5oxruv0u\*\*\*\* |资源的ID。|\ | | | | ||\ | | | | |* 参数 \- N：表示资源 ID的序号，取值范围 1～20。|\ | | | | |* 多个资源 ID之间使用&分隔。|\ | | | | ||\ | | | | |:::tip|\ | | | | ||\ | | | | |* 您可以调用[DescribeNetworkLoadBalancers](https://www.volcengine.com/docs/6406/1275763)接口，查询NLB实例的ID。|\ | | | | |* 您可以调用[DescribeNLBListeners](https://www.volcengine.com/docs/6406/1275768)接口，查询监听器的ID。|\ | | | | |* 您可以调用[DescribeNLBServerGroups](https://www.volcengine.com/docs/6406/1275775)接口，查询服务器组的ID。|\ | | | | |* 您可以调用[DescribeNLBSecurityPolicies](https://www.volcengine.com/docs/6406/1550848) 接口，查询TLS自定义安全策略的ID。|\ | | | | ||\ | | | | |:::| |Tags.N.Key |String |是 |Tags.1.Key=key1&Tags.2.Key=key2 |用户标签的标签键。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签键的序号，取值范围：1～20。|\ | | | | |* 多个标签键之间用&分隔。|\ | | | | |* 不能以 `volc:`或`sys:`开头，包括任意大小写形式。|\ | | | | |* 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（\-）和@（@）。|\ | | | | |* 若标签键开头或结尾存在空格，系统会自动为其去除。|\ | | | | ||\ | | | | |:::tip|\ | | | | |同一资源的标签键不允许重复。|\ | | | | ||\ | | | | |:::| |Tags.N.Value |String |否 |Tags.1.Value=value1&Tags.2.Value=value2 |用户标签的标签值。|\ | | | | ||\ | | | | |* 参数 \- N：表示标签值的序号，取值范围：1～20。|\ | | | | |* 多个标签值之间用&分隔。|\ | | | | |* 长度取值范围为0～256字符，不填默认为空。|\ | | | | |* 允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（\-）和@（@）。|\ | | | | |* 大小写敏感。|\ | | | | |* 若标签值开头或结尾存在空格，系统会自动为其去除。|\ | | | | ||\ | | | | |:::tip|\ | | | | |若传入该参数，则必须先传入Tags.N.Key。|\ | | | | ||\ | | | | |:::| ## 返回参数 |名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2024062415303301022514515207C4\*\*\*\* |请求ID。 | ## 请求示例 ```Plain Text GET /?Action=TagNLBResources&Version=2020-04-01&ResourceType=nlb&ResourceIds.1=nlb-273sdsdsrfp8u2j****&ResourceIds.2=nlb-2fe6fszjgeznk5oxruv0u****&Tags.1.Key=k1&Tags.2.Key=k2&Tags.1.Value=v1&Tags.2.Value=v2 HTTP/1.1 Host: open.volcengineapi.com Region: cn-guangzhou Service: clb ``` ## 返回示例 ```Plain Text { "ResponseMetadata": { "RequestId": "2024062415303301022514515207C4****", "Action": "TagNLBResources", "Version": "2020-04-01", "Service": "clb", "Region": "cn-guangzhou" }, "Result": { "RequestId": "2024062415303301022514515207C4****" } } ``` ## 错误码此处仅展示当前API的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/1264688)。 |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |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. |发生内部错误。 |

负载均衡