调用UpdateLoadBalancerEdition变更负载均衡版本_负载均衡(SLB)-阿里云帮助中心

变更当前负载均衡版本。

接口说明

ALB 实例仅支持基础版升级为标准版和 WAF 增强版，WAF 增强版变更为标准版，不支持标准版和 WAF 增强版变更为基础版。具体操作，请参见升级实例功能版本。
UpdateLoadBalancerEdition 接口属于异步接口，即系统返回一个请求 ID，但该应用型负载均衡版本尚未修改成功，系统后台的修改任务仍在进行。您可以调用 GetLoadBalancerAttribute 查询应用型负载均衡版本的修改状态：
- 当应用型负载均衡版本处于 Configuring 状态时，表示应用型负载均衡版本正在修改中。
- 当应用型负载均衡版本处于 Active 状态时，表示应用型负载均衡版本修改成功。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作
alb:UpdateLoadBalancerEdition	Write	LoadBalancer acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}	无	无

名称	类型	必填	描述	示例值
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
DryRun	boolean	否	是否只预检此次请求，取值： true：发送检查请求，不会修改应用型负载均衡版本。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回`HTTP_2xx`状态码并直接进行修改。	false
LoadBalancerId	string	是	应用型负载均衡实例 ID。	alb-bp1b6c719dfa08ex****
LoadBalancerEdition	string	是	应用型负载均衡的版本，不同版本有不同功能限制和计费策略。 Basic：基础版。 Standard：标准版。 StandardWithWaf：WAF 增强版。	Standard

名称	类型	描述	示例值
	object	修改负载均衡版本。
RequestId	string	请求 ID。	593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3

正常返回示例

JSON格式

{
  "RequestId": "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3"
}

HTTP status code	错误码	错误信息	描述
400	IncorrectStatus.LoadBalancer	The status of %s [%s] is incorrect.	资源%s [%s]的状态无效。
400	IncorrectBusinessStatus.LoadBalancer	The business status of %s [%s] is incorrect.	资源%s [%s]的业务状态无效。
400	OperationDenied.Downgrade	The operation is not allowed because of %s.	操作被拒绝，原因是%s。
400	OperationDenied.EditionNotChanged	The operation is not allowed because of %s.	操作被拒绝，原因是%s。
404	ResourceNotFound.LoadBalancer	The specified resource %s is not found.	资源%s不存在。

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作

暂无变更历史