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

文档中心

导航

ModifyNLBBackendServersAttributes

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

调用 ModifyNLBBackendServersAttributes 接口，修改服务器组中后端服务器的权重、端口或描述。

请求参数

下表中，Servers.N.a类型参数中的“N”表示后端服务器信息的序号。取值范围为1 ～ 20。多个后端服务器间使用&分隔。

名称	类型	是否必选	示例值	说明
Action	String	是	ModifyNLBBackendServersAttributes	要执行的操作，取值 ModifyNLBBackendServersAttributes。
ServerGroupId	String	是	rsp-bp1o94dp5i6ea****	服务器组ID。您可以调用DescribeNLBServerGroups接口获取服务器组ID。
Servers.N.ServerId	String	是	Servers.1.ServerId=rs-124e87shgdqwrc**&Servers.2.ServerId=rs-124e87shgdasde**	后端服务器 ID。您可以调用DescribeNLBServerGroupAttributes接口获取后端服务器的ID。
Servers.N.Port	Integer	否	Servers.1.Port=1234&Servers.2.Port=2345	后端服务器处理请求的端口，取值范围为 1～65535。服务器组未开启全端口转发时，该参数为必填。服务器组开启全端口转发时，该参数默认为0。
Servers.N.Weight	Integer	否	Servers.1.Weight=100&Servers.2.Weight=100	后端服务器的权重，取值范围为0 ～ 100。权重为0，表示NLB不会将请求转发给该后端服务器。该参数不传入，则默认为0。
Servers.N.Description	String	否	Servers.1.Description=ecs1&Servers.2.Description=eni1	后端服务器的描述。必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）长度限制为1 ～ 255个字符。

返回参数

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

请求示例

GET /?Action=ModifyNLBBackendServersAttributes&Version=2020-04-01&ServerGroupId=rsp-bp1o94dp5i6ea****&ServerIds.1=rs-3cig8e5o0kxs06c6rrsqn****&Servers.1.Port=1234&Servers.2.Port=2345 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-guangzhou
Service: clb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202409291106382514606306AF947C****",
        "Action": "ModifyNLBBackendServersAttributes",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-guangzhou"
    },
    "Result": {
        "RequestId": "20240929110622514606306AF947C****",
    }
}

错误码

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