You need to enable JavaScript to run this app.
文档中心
负载均衡

负载均衡

复制全文
下载 pdf
实例
ModifyLoadBalancerAttributes - 修改 ALB 实例
复制全文
下载 pdf
ModifyLoadBalancerAttributes - 修改 ALB 实例
调用 ModifyLoadBalancerAttributes 接口,修改 ALB 实例。​
使用说明​
  • 每秒最多提交 10 个 API 请求。​
  • 以下可选参数如不配置,则保持原有配置。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:ModifyLoadBalancerAttributes​
要执行的操作,取值:ModifyLoadBalancerAttributes。​
​
Version string 必选 示例值: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 个字符。​
说明​
  • 仅当 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 必选 示例值:alb-bp1b6c719dfa08ex****​
ALB 实例ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId string 示例值:20210811152539010225146063030****​
请求ID。​
​
​
​
请求示例​
​
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​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20210816110638****2514606306AF947C",​
"Action": "ModifyLoadBalancerAttributes",​
"Version": "2020-04-01",​
"Service": "alb",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "20210816110638****2514606306AF947C"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
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.​
发生内部错误。请稍后重试或联系工程师进一步咨询。​
​
​
最近更新时间:2026.02.27 10:54:53
这个页面对您有帮助吗?
有用
有用
无用
无用