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

负载均衡

复制全文
下载 pdf
CLB实例
ModifyLoadBalancerAttributes - 修改负载均衡属性
复制全文
下载 pdf
ModifyLoadBalancerAttributes - 修改负载均衡属性
调用 ModifyLoadBalancerAttributes 接口,修改指定CLB实例。​
使用说明​
调用本接口时,若可选参数未进行配置,则该可选参数的配置保持原状。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:ModifyLoadBalancerAttributes​
要执行的操作,取值:ModifyLoadBalancerAttributes。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
LoadBalancerId String 必选 示例值:clb-bp1b6c719dfa08ex****​
CLB实例ID。​
您可以调用 DescribeLoadBalancers 接口,查询CLB实例ID。​
​
LoadBalancerName String 可选 示例值:clb-1​
CLB实例的名称。​
  • 必须以字母、数字或中文开头,可包含字母、数字、中文及以下特殊字符:点号(.)、下划线(_)和中划线(-)。​
  • 长度限制为1 ~ 128个字符。​
​
Description String 可选 示例值:test​
CLB实例的描述。​
  • 必须以字母、数字或中文开头,可包含字母、数字、中文及以下特殊字符:英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、中划线(-)、中文逗号(,)、中文句号(。)。​
  • 长度限制为0 ~ 255个字符。​
​
LoadBalancerSpec String 可选 示例值:small_1​
CLB实例的规格,不同规格提供的转发能力不同,具体请参见产品类型与规格。取值如下:​
  • small_1:小型I​
  • small_2:小型II​
  • medium_1:中型I​
  • medium_2:中型II​
  • large_1:大型I​
  • large_2:大型II​
说明​
修改后的实例规格带宽应大于等于已配置监听器的带宽总和,否则无法修改规格。​
​
Type String 可选 示例值:private​
CLB实例的类型。取值如下:​
private:表示将公网CLB实例转换为私网实例。转换后CLB实例与关联的公网IP生命周期独立,您可以按需解绑公网IP。​
​
AddressIpVersion String 可选 示例值:DualStack​
CLB实例的IP版本。支持私网CLB实例IPv4与双栈的相互转换。公网CLB实例如需转换,请先参考公网实例转换为私网实例将其转换为私网实例。​
  • ipv4:仅IPv4。​
  • DualStack:双栈。​
说明​
该参数正在邀测中,如需试用,请联系客户经理。​
​
EniIpv6Address String 可选 示例值:2408:4005:XX:XX:200​
CLB实例的IPv6地址。​
仅AddressIpVersion从ipv4修改为DualStack时,本参数有效。​
  • 从子网中指定一个空闲的私网IPv6地址。​
  • 不填自动从子网中分配一个空闲的私网IPv6地址。​
​
ModificationProtectionStatus String 可选 示例值:ConsoleProtection​
CLB实例是否开启控制台上修改保护。开启后,禁止通过控制台修改实例或删除实例。取值如下:​
  • NonProtection或空:不开启。​
  • ConsoleProtection:开启。​
​
ModificationProtectionReason String 可选 示例值:托管实例​
设置控制台修改保护的原因。​
仅参数ModificationProtectionStatus取ConsoleProtection时,本参数有效。​
  • 必须以字母、数字或中文开头,可包含字母、数字、中文及以下特殊字符:半角句号(.)、下划线(_)和中划线(-)。​
  • 长度限制为1 ~ 80个字符。​
​
BypassSecurityGroupEnabled String 可选 示例值:off​
CLB实例是否开启“放通后端安全组”功能。​
  • on:开启。开启之后,后端服务器组(仅服务器类型)中的云服务器的安全组不再校验CLB的流量,默认放通。​
  • off:未开启。​
​
TimestampRemoveEnabled String 可选 示例值:off​
是否开启清除TCP/HTTP/HTTPS报文的timestamp(即时间戳)的功能。​
  • on:开启。​
  • off:不开启。​
说明​
本功能正在邀测中,如需试用,请联系客户经理。​
​
​
​
返回参数​
RequestId String 示例值:202108161106382514606306AF947C****​
请求ID。​
​
​
​
请求示例​
​
GET /?Action=ModifyLoadBalancerAttributes&Version=2020-04-01&Description=test&LoadBalancerId=clb-bp1b6c719dfa08ex****&LoadBalancerName=clb-test1&LoadBalancerSpec=small_1&ModificationProtectionReason=实例托管&ModificationProtectionStatus=ConsoleProtection HTTP/1.1​
Host: clb.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/clb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202108161106382514606306AF947C****",​
"Action": "ModifyLoadBalancerAttributes",​
"Version": "2020-04-01",​
"Service": "clb",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "202108161106382514606306AF947C****"​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidAddressIpVersion.Malformed​
The specified AddressIpVersion is malformed.​
指定的 AddressIpVersion 参数格式不合法。​
400​
InvalidAddressIpVersionConvert.UnSupport​
The specified LoadBalancer not support convert address Ip version.​
指定的负载均衡不支持 IP 类型转换。​
400​
InvalidAllowedPorts.Conflict​
The specified AllowedPorts has conflict.​
指定的允许端口范围存在重叠。​
400​
InvalidAllowedPorts.InUse​
The specified AllowedPorts is in use.​
指定的允许端口范围存在监听器在占用中。​
400​
InvalidAllowedPorts.Malformed​
The specified AllowedPorts is malformed.​
指定的 AllowedPorts 参数格式不合法。​
400​
InvalidBandwidth.Malformed​
The specified Bandwidth is malformed.​
指定的 Bandwidth 参数格式不合法。​
400​
InvalidBypassSecurityGroupEnabled.Malformed​
The specified BypassSecurityGroupEnabled is malformed.​
指定的 BypassSecurityGroupEnabled 参数格式不合法。​
400​
InvalidBypassSecurityGroupEnabled.NotSupport​
The specified LoadBalancer does not support BypassSecurityGroupEnabled.​
指定的负载均衡不支持 Bypass 安全组功能。​
400​
InvalidEniIpv6Address.Malformed​
The specified EniIpv6Address is malformed.​
指定的 EniIpv6Address 参数格式不合法。​
400​
InvalidLoadBalancer.InvalidStatus​
The specified LoadBalancer is not in the correct status for the request.​
指定的负载均衡所处状态无法响应该请求。​
400​
InvalidLoadBalancerDescription.Malformed​
The specified LoadBalancerDescription is malformed.​
指定的 LoadBalancerDescription 参数格式不合法。​
400​
InvalidLoadBalancerName.Malformed​
The specified LoadBalancerName is malformed.​
指定的 LoadBalancerName 参数格式不合法。​
400​
InvalidLoadBalancerSpec.ListenerBandwidthMismatch​
The total bandwidth of all listeners exceeds the upper limit of the specified spec.​
实例内监听器指定带宽总和超过指定的负载均衡规格上限。​
400​
InvalidLoadBalancerSpec.Malformed​
The specified LoadBalancerSpec is malformed.​
指定的 LoadBalancerSpec 参数格式不合法。​
400​
InvalidModificationProtectionReason.Malformed​
The specified ModificationProtectionReason is malformed.​
指定的 ModificationProtectionReason 参数格式不合法。​
400​
InvalidModificationProtectionStatus.Malformed​
The specified ModificationProtectionStatus is malformed.​
指定的 ModificationProtectionStatus 参数格式不合法。​
400​
InvalidQuotaCode.Malformed​
The specified QuotaCode is malformed.​
指定的 QuotaCode 参数格式不合法。​
400​
InvalidSubnetIPv6Cidr.NotSupport​
The specified subnet does not support ipv6 cidr.​
指定子网不支持IPv6网段。​
400​
InvalidTimestampRemoveEnabled.Malformed​
The specified TimestampRemoveEnabled is malformed.​
指定的 TimestampRemoveEnabled 参数格式不合法。​
400​
InvalidType.Malformed​
The specified Type is malformed.​
指定的 Type 参数格式不合法。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'LoadBalancerId'.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 LoadBalancerId。​
400​
MissingParameter​
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the ''.​
该请求缺少必要参数。请确保发起请求已提供全部必要参数,比如 。​
400​
OrderError.OrderPay​
Failed to create order and pay.​
下单支付失败。​
400​
OrderError.PreOrder​
Failed to create a preorder.​
下单失败。​
400​
QuotaExceed.AllowedPortNumberEachInstance​
You've reached the limit on the number of AllowedPort that you can operate.​
已达到可配置的允许端口范围的数量上限。​
400​
QuotaExceed.XLargeOneInstanceNumber​
You've reached the limit on the number of xlarge_1 instance that you can create.​
已达到可创建的超大型I负载均衡实例数量的配额上限。​
400​
QuotaExceed.XLargeTwoInstanceNumber​
You've reached the limit on the number of xlarge_2 instance that you can create.​
已达到可创建的超大型II负载均衡实例数量的配额上限。​
400​
UnSupportedOperation.SpecUnchanged​
The request on the specified LoadBalancer is denied due to the LoadBalancerSpec has not changed.​
负载均衡规格未改变。​
400​
UnsupportedOperation.AccountArrears​
The request on the specified instance is denied due to the account in arrears status.​
因账户处于欠费状态,对于该实例的操作请求被拒绝。​
400​
UnsupportedOperation.AccountArrears​
The request on the specified instance is denied due to the account balance and available vouchers are less than 100 yuan in total.​
因账户余额及可用代金券共不足100元,对于该实例的操作请求被拒绝。​
403​
Forbidden​
The specified LoadBalancer not support convert address IP version, because owner of the Eni is not in sharing.​
指定的负载均衡不支持 IP 类型转换, 因为 Eni 归属用户不在共享中。​
403​
Forbidden​
You are not authorized to perform operations on the specified service; for example, the 'AllowedPorts'.​
无权限对指定服务进行操作,比如 AllowedPorts。​
403​
Forbidden​
You are not authorized to perform operations on the specified service.​
无权限对指定服务进行操作。​
403​
Forbidden​
You are not authorized to perform operations on the specified service; for example, the 'TimestampRemoveEnabled'.​
无权限对指定服务进行操作,比如 TimestampRemoveEnabled。​
403​
InvalidResourceType.ServcieManaged​
The specified ResourceType is managed by a service.​
指定的资源是服务托管资源。​
404​
InvalidExclusiveCluster.NotFound​
The specified ExclusiveCluster does not exist.​
指定的独占集群不存在。​
404​
InvalidLoadBalancer.NotFound​
The specified LoadBalancer does not exist.​
指定的负载均衡不存在。​
404​
InvalidLoadBalancerSpec.NotFound​
The specified LoadBalancerSpec does not exist.​
指定的负载均衡规格不存在。​
409​
InvalidAllowedPort.Conflict​
The specified AllowedPort already exists.​
指定的允许端口范围已存在。​
412​
InvalidExclusiveCluster.Expired​
The specified ExclusiveCluster has expired.​
指定的独占集群已过期。​
412​
InvalidExclusiveCluster.UnPurchased​
The specified ExclusiveCluster is not purchased.​
指定的独占集群未购买。​
412​
InvalidLoadBalancer.Expired​
The specified LoadBalancer has expired.​
指定的负载均衡已过期。​
412​
InvalidLoadBalancer.InvalidBillingType​
The specified LoadBalancer is not in the correct BillingType for the request.​
指定的负载均衡所处计费类型无法响应该请求。​
500​
InternalError​
An internal error has occurred.​
发生内部错误。​
​
​
最近更新时间:2026.06.04 10:48:07
这个页面对您有帮助吗?
有用
有用
无用
无用