TagNLBResources--负载均衡-火山引擎

文档中心

立即注册

导航

TagNLBResources

最近更新时间：2024.12.04 17:10:14首次发布时间：2024.12.04 17:10:14

调用 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：服务器组。
ResourceIds.N	String	是	ResourceIds.1=nlb-273sdsdswrfdp8u2j**&ResourceIds.2=nlb-2fe6fszjgeznk5oxruv0u**	资源的ID。 N：表示资源 ID的序号，取值范围 1～50。多个资源 ID之间使用&分隔。说明您可以调用DescribeNetworkLoadBalancers接口获取NLB实例的ID。您可以调用DescribeNLBListeners接口获取监听器的ID。您可以调用DescribeNLBServerGroups接口获取服务器组的ID。
Tags.N.Key	String	是	Tags.1.Key=k1&Tags.2.Key=k2	用户标签的标签键。 N：表示标签信息的序号，需按照数字顺序从1开始填写，取值范围 1～20。多个标签键之间使用&分隔。长度限制为1～128个字符。大小写敏感，不能以`volc:`或`sys:`的任意大小写组合开头。不能以空格开头或结尾。允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（-）和@。说明同一资源的标签键不允许重复。如果传入的`Tags.N.Key`与已有标签的标签键重复，则后添加的标签会覆盖原有标签。
Tags.N.Value	String	否	Tags.1.Value=v1&Tags.2.Value=v2	用户标签的标签值。 N：表示标签信息的序号，需按照数字顺序从1开始填写，取值范围 1～20。多个标签值之间使用&分隔。每个标签键对应一个标签值。长度限制为1～256个字符。大小写敏感，不能以空格开头或结尾。允许包含各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、减号（-）和@。说明如果传入该参数，则必须先传入`Tags.N.Key`。

返回参数

名称	类型	示例值	描述
RequestId	String	2024062415303301022514515207C4****	请求ID。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2024062415303301022514515207C4****",
        "Action": "TagNLBResources",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-guangzhou"
    },
    "Result": {
        "RequestId": "2024062415303301022514515207C4****"
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。