调用 ModifyLoadBalancerAttributes 接口，修改 ALB 实例。 ## 使用说明 * 每秒最多提交 10 个 API 请求。 * 以下可选参数如不配置，则保持原有配置。 ## 调试 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string %%require%% `示例值：ModifyLoadBalancerAttributes` 要执行的操作，取值：ModifyLoadBalancerAttributes。 **Version** string %%require%% `示例值：2020-04-01` API的版本，取值：2020\-04\-01。 **Description** string `可选` `示例值：This is an ALB instance` ALB 实例的描述。 * 不能以http://或https://开头。 * 必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。）。 * 长度限制为1 ～ 255个字符。 **DeleteProtection** string `可选` `示例值：off` ALB删除保护功能。 * off：关闭。 * on：开启。 **LoadBalancerName** string `可选` `示例值：alb-test1` ALB 实例的名称。 * 不能以http://或https://开头。 * 必须以字母或中文开头，可包含数字、点号（.）、下划线（_）和短横线（\-）。 * 长度限制为1 ～ 128个字符。 **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。 **ModificationProtectionReason** string `可选` `示例值：This is modification protection` 填写启用实例修改保护的原因。 * 必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。）。 * 长度限制为 0~128 个字符。 :::tip * 仅当 `ModificationProtectionStatus` 参数的值为 `ConsoleProtection`时，`ModificationProtectionReason` 参数的值有效且合法。 * 当`ModificationProtectionStatus` 参数的值为`NonProtection`时，之前配置的`ModificationProtectionReason`参数值会被清空。 ::: **ModificationProtectionStatus** string `可选` `示例值：NonProtection` 是否启用实例修改保护功能。取值如下： * NonProtection：不启用。 * ConsoleProtection：启用。启用后，您无法通过 ALB 控制台修改实例配置，只能调用 API 修改实例配置。 **ProxyProtocolEnabled** string `可选` `示例值：off` ALB 可支持 Proxy Protocol 协议并记录客户端真实 IP。 * off：关闭 Proxy Protocol。 * on：开启 Proxy Protocol。 **LoadBalancerId** string %%require%% `示例值：alb-bp1b6c719dfa08ex****` ALB 实例ID。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **RequestId** string `示例值：20210811152539010225146063030****` 请求ID。 ## 请求示例 ```text 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 ``` ## 返回示例 ```text { "ResponseMetadata": { "RequestId": "20210816110638****2514606306AF947C", "Action": "ModifyLoadBalancerAttributes", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210816110638****2514606306AF947C" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |Invalid%s.Malformed |MismatchThe specified %s is malformed. |指定的 %s 参数格式不合法。 | |400 |MissingParameter |The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, '%s'. |该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如: %s。 | |400 |InvalidParameter |Data unmarshal failed. |请求解析失败。 | |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 实例所处状态无法响应该请求。 | |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 参数格式不合法。 | |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 服务失败，对于该资源的操作请求失败。 | |400 |OperationDenied.WafProtectionOnLocalZoneNotSupported |The request on the specified LoadBalancer is denied due to the LoadBalancer with WAF Protection is not allowed to be deployed on local zone. |因仅支持部署在标准可用区的 ALB 实例开启 WAF 安全防护，对于该 ALB 实例的操作请求被拒绝。 | |404 |InvalidLoadBalancer.NotFound |The specified LoadBalancer does not exist. |指定的 ALB 实例不存在。 | |409 |InvalidWafProtectedDomain.Conflict |The specified WafProtectedDomain already exists. |指定的 WAF 防护域名已存在。 | |500 |InternalError |An internal error has occurred. |发生内部错误。请稍后重试或联系工程师进一步咨询。 |