调用 ModifyLoadBalancerAttributes 接口，修改 ALB 实例。 ## 使用说明 * 每秒最多提交 10 个 API 请求。 * 以下可选参数如不配置，则保持原有配置。 ## 调试 ## 请求参数 **Action** String %%require%% `示例值：ModifyLoadBalancerAttributes` 接口名称。当前 API 的名称为 `ModifyLoadBalancerAttributes`。 **Version** String %%require%% `示例值：2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **LoadBalancerId** String %%require%% `示例值：alb-bp1b6c719dfa08ex****` ALB 实例ID。 **LoadBalancerName** String `可选` `示例值：alb-test1` ALB 实例的名称。 * 不能以http://或https://开头。 * 必须以字母或中文开头，可包含数字、点号（.）、下划线（_）和短横线（\-）。 * 长度限制为1 ～ 128个字符。 **Description** String `可选` `示例值：This is an ALB instance` ALB 实例的描述。 * 不能以http://或https://开头。 * 必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。）。 * 长度限制为1 ～ 255个字符。 **DeleteProtection** String `可选` `示例值：off` ALB删除保护功能。 * off：关闭。 * on：开启。 **WafProtectionEnabled** String `可选` `示例值：off` WAF 安全防护开关。 * off：关闭。 * on：开启。 **WafInstanceId** String `可选` `示例值：waf-14ca6f67c33c09****` ALB 实例绑定的 WAF 安全防护实例 ID。 **WafProtectedDomain** String `可选` `示例值：www.test.com` WAF 安全防护域名。 * 当 WafProtectionEnabled 为 on 时，该参数可选，当 WafProtectionEnabled 为 off 时，该参数无效。 * 支持精确域名和泛域名。 **GlobalAccelerator.AcceleratorId** String `可选` `示例值：accinstance-VYjG****` 全球加速器的 ID。 **GlobalAccelerator.AcceleratorListenerId** String `可选` `示例值：listener-rrhN7WbeeYo****` 全球加速器监听器的 ID。 **GlobalAccelerator.EndpointGroupId** String `可选` `示例值：endpointgroup-NoT****` 终端节点组的 ID。 **GlobalAccelerator.Weight** Integer `可选` `示例值：100` 终端节点的流量分配权重。取值范围为：1 \- 100。 **ModificationProtectionStatus** String `可选` `示例值：NonProtection` 是否启用实例修改保护功能。取值如下： * NonProtection：不启用。 * ConsoleProtection：启用。启用后，您无法通过 ALB 控制台修改实例配置，只能调用 API 修改实例配置。 **ModificationProtectionReason** String `可选` `示例值：This is modification protection` 填写启用实例修改保护的原因。 * 必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。）。 * 长度限制为 0~128 个字符。 :::tip * 仅当 `ModificationProtectionStatus` 参数的值为 `ConsoleProtection`时，`ModificationProtectionReason` 参数的值有效且合法。 * 当`ModificationProtectionStatus` 参数的值为`NonProtection`时，之前配置的`ModificationProtectionReason`参数值会被清空。 ::: **ProxyProtocolEnabled** String `可选` `示例值：off` ALB 可支持 Proxy Protocol 协议并记录客户端真实 IP。 * off：关闭 Proxy Protocol。 * on：开启 Proxy Protocol。 ## 返回参数 **RequestId** String `示例值：20210811152539010225146063030****` 请求ID。 ## 请求示例 ```JSON GET /?Action=ModifyLoadBalancerAttributes&Version=2020-04-01&Description=test&LoadBalancerId=alb-bp1b6c719dfa08ex****&LoadBalancerName=lb1 HTTP/1.1 Host: alb.cn-beijing.volcengineapi.com X-Date: 20251121T094038Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/alb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20210816110638****2514606306AF947C", "Action": "ModifyLoadBalancerAttributes", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210816110638****2514606306AF947C", } } ``` ## 错误码如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/113579)。 |**状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |400 |InvalidLoadBalancerName.Malformed |The specified LoadBalancerName is malformed. |指定的 LoadBalancerName 参数格式不合法。 | |400 |InvalidDescription.Malformed |The specified Description is malformed. |指定的 Description 参数格式不合法。 | |400 |InvalidDeleteProtection.Malformed |The specified DeleteProtection is malformed. |指定的 DeleteProtection 参数格式不合法。 | |400 |InvalidLoadBalancer.InvalidStatus |The specified LoadBalancer is not in the correct status for the request. |指定的 ALB 实例所处状态无法响应该请求。 | |404 |InvalidLoadBalancer.NotFound |The specified LoadBalancer does not exist. |指定的 ALB 实例不存在。 | |400 |InvalidWafProtectionEnabled.Malformed |The specified WafProtectionEnabled is malformed. |指定的 WafProtectionEnabled 参数格式不合法。 | |400 |InvalidWafInstanceId.Malformed |The specified WafInstanceId is malformed. |指定的 WafInstanceId 参数格式不合法。 | |400 |InvalidWafProtectedDomain.Malformed |The specified WafProtectedDomain is malformed. |指定的 WafProtectedDomain 参数格式不合法。 | |409 |InvalidWafProtectedDomain.Conflict |The specified WafProtectedDomain already exists. |指定的 WAF 防护域名已存在。 | |400 |LimitExceed.WafProtectedDomain |You've reached the limit on the number of domain you can associate with the waf instance. |已达到单个 WAF 实例可添加的防护域名数量上限。 | |400 |OperationFailed.QueryWafService |The request on the specified resource failed due to the query on WAF Service failed. |因请求 WAF 服务失败，对于该资源的操作请求失败。 |