文档中心

负载均衡

API 参考

API 发布历史

本文为您介绍ALB的API更新动态。

2026年9月

接口名称	变更记录	关联功能
DescribeRules	新增返回数据InsertHeaderConfig。	转发规则

2026年7月

接口名称	变更记录	关联功能
CreateRules	请求参数变更：Rules.N.RuleActions.N.Type新增取值InsertHeader。新增请求参数：Rules.N.RuleActions.N.InsertHeaderConfig。新增错误码：InvalidRules.RuleActions.InsertHeaderConfig.Key.Malformed、InvalidRules.RuleActions.InsertHeaderConfig.Value.Malformed、InvalidRules.RuleActions.InsertHeaderConfig.ValueType.Malformed、Forbidden、ErrServerGroupTypeMountUnSupported。	转发规则
ModifyRules
DescribeRules	新增响应参数InsertHeaderConfig。
AddServerGroupBackendServers	新增错误码ErrInvalidServerDomain、ErrDomainServerGroupOnlyOneServer、ErrDomainServerNotSupportIp、ErrDomainServerNotSupportRemote。	服务器组
CreateCustomizedCfg	新增错误码ErrCustomizedCfgMaxHeaders、ErrCustomizedCfgMaxHeadersRepeat。	个性化配置
ModifyCustomizedCfgAttributes		个性化配置
ModifyLoadBalancerType	新增错误码InvalidLoadBalancer.InUse。	ALB实例

2026年5月

接口名称	变更记录	关联功能
DescribeRules	新增返回参数：SourceIpConfig、CookieConfig、CorsConfig	转发规则
CreateRules	新增请求参数：Rules.N.RuleConditions.N.CookieConfig.Values.N.Key、Rules.N.RuleActions.N.CorsConfig.AllowHeaders.N、Rules.N.RuleActions.N.CorsConfig.AllowMethods.N、Rules.N.RuleConditions.N.SourceIpConfig.Values.N、Rules.N.RuleConditions.N.CookieConfig.Values.N.Value、Rules.N.RuleActions.N.CorsConfig.AllowOrigin.N、Rules.N.RuleActions.N.CorsConfig.ExposeHeaders.N、Rules.N.RuleActions.N.CorsConfig.AllowCredentials、Rules.N.RuleActions.N.CorsConfig.MaxAge 新增错误码：InvalidRules.RuleConditions.SourceIpConfig.Values.Malformed、InvalidRules.RuleActions.CorsConfig.AllowMethods.Malformed、InvalidRules.RuleActions.CorsConfig.AllowOrigin.Malformed、InvalidRules.RuleConditions.SourceIpConfig.Duplicated、InvalidRules.RuleConditions.CookieConfig.Values.Duplicated、InvalidRules.RuleActions.CorsConfig.AllowHeaders.Malformed、InvalidRules.RuleActions.CorsConfig.ExposeHeaders.Malformed、InvalidRules.RuleActions.CorsConfig.AllowCredentials.Malformed、InvalidRules.RuleActions.CorsConfig.MaxAge.Malformed、InvalidRules.RuleConditions.CookieConfig.Values.Key.Malformed、InvalidRules.RuleConditions.CookieConfig.Values.Value.Malformed、InvalidRules.RuleConditions.SourceIpConfig.Values.Duplicated、Forbidden
ModifyRules	新增请求参数：Rules.N.RuleActions.N.CorsConfig.AllowCredentials、Rules.N.RuleConditions.N.CookieConfig.Values.N.Key、Rules.N.RuleConditions.N.CookieConfig.Values.N.Value、Rules.N.RuleActions.N.CorsConfig.AllowOrigin.N、Rules.N.RuleActions.N.CorsConfig.AllowMethods.N、Rules.N.RuleActions.N.CorsConfig.AllowHeaders.N、Rules.N.RuleConditions.N.SourceIpConfig.Values.N、Rules.N.RuleActions.N.CorsConfig.ExposeHeaders.N、Rules.N.RuleActions.N.CorsConfig.MaxAge、Rules.N.RuleActions.N.RedirectConfig.Query 新增错误码：InvalidRules.RuleActions.CorsConfig.AllowHeaders.Malformed、InvalidRules.RuleConditions.CookieConfig.Values.Key.Malformed、InvalidRules.RuleActions.CorsConfig.MaxAge.Malformed、InvalidRules.RuleActions.CorsConfig.AllowCredentials.Malformed、InvalidRules.RuleActions.CorsConfig.ExposeHeaders.Malformed、InvalidRules.RuleActions.CorsConfig.AllowMethods.Malformed、InvalidRules.RuleActions.CorsConfig.AllowOrigin.Malformed、InvalidRules.RuleConditions.SourceIpConfig.Values.Malformed、InvalidRules.RuleConditions.SourceIpConfig.Duplicated、InvalidRules.RuleConditions.CookieConfig.Values.Duplicated、InvalidRules.RuleConditions.CookieConfig.Values.Value.Malformed、InvalidRules.RuleConditions.SourceIpConfig.Values.Duplicated、InvalidRules.RuleActions.RedirectConfig.Query.Malformed、Forbidden
DescribeServerGroupAttributes	新增返回参数：SlowStartConfig	后端服务器组
DescribeServerGroups	新增返回参数：SlowStartConfig
CreateServerGroup	新增请求参数：SlowStartConfig.SlowStartEnabled、SlowStartConfig.SlowStartDuration 新增错误码：InvalidSlowStartConfig.SlowStartEnabled.Malformed、InvalidSlowStartConfig.SlowStartDuration.Malformed、InvalidScheduler.SlowStartEnabledMismatch、Forbidden
ModifyServerGroupAttributes	新增请求参数：SlowStartConfig.SlowStartEnabled、SlowStartConfig.SlowStartDuration 新增错误码：InvalidSlowStartConfig.SlowStartEnabled.Malformed、InvalidSlowStartConfig.SlowStartDuration.Malformed、InvalidScheduler.SlowStartEnabledMismatch、Forbidden

2026年4月

接口名称	变更记录	关联功能
CreateServerGroup	新增请求参数：SlowStartConfig.SlowStartEnabled、SlowStartConfig.SlowStartDuration。新增错误码：InvalidSlowStartConfig.SlowStartEnabled.Malformed、InvalidSlowStartConfig.SlowStartDuration.Malformed、InvalidScheduler.SlowStartEnabledMismatch、Forbidden。	服务器组
ModifyServerGroupAttributes
DescribeServerGroupAttributes	新增参数数据SlowStartConfig。
DescribeServerGroups	新增参数数据SlowStartConfig。

2026年3月

接口名称	变更记录	关联功能
CreateRules	新增请求参数：Rules.N.RuleConditions.N.SourceIpConfig.Values.N。请求参数新增：CorsConfig。请求参数RuleActions增加新的取值Cors。请求参数Rules.N.RuleActions.N.Type新增取值Cookie、SourceIp。	转发规则
DescribeRules
ModifyRules

2026年1月

接口名称	变更记录	关联功能
ModifyServerGroupBackendServers	新增请求参数：Servers.N.InstanceId，表示ECS实例的ID。	后端服务器组
CreateListener	新增请求参数：XRealIpEnabled，表示监听器开启或禁用获取客户端源IP。	监听器
ModifyListenerAttributes	新增请求参数：XRealIpEnabled，表示监听器开启或禁用获取客户端源IP。
DescribeListeners	新增返回参数：XRealIpEnabled，表示监听器开启或禁用获取客户端源IP。
DescribeListenerAttributes	新增返回参数：XRealIpEnabled，表示监听器开启或禁用获取客户端源IP。
DescribeRules	新增返回参数：RedirectDomain，表示重定向域名。	转发规则
DeleteRules	新增返回参数：RedirectDomain，表示重定向域名。
ModifyRules	新增请求参数：Rules.N.RedirectConfig.RedirectDomain，表示重定向域名。
CreateRules	新增请求参数：Rules.N.RedirectConfig.RedirectDomain，表示重定向域名。

2025年7月

接口名称	变更记录	关联功能
CreateRules	修改请求参数：TrafficLimitQps 、TrafficLimitConfig.QPS 的取值范围由 100~150000 调整为 100~400000。新增请求参数：QueryStringConfig ，用于在转发条件中指定查询字符串。	转发规则
ModifyRules
DescribeRules	新增返回参数： QueryStringConfig ，表示在转发条件中指定的查询字符串。
CreateListener	新增请求参数： CACertificateSource ，用于指定 CA 证书来源。 PcaRootCACertificateId ，用于指定私有根 CA 证书作为 CA 证书。 PcaSubCACertificateId ，用于指定私有子 CA 证书作为 CA 证书。新增私有 CA 证书相关的错误码。	监听器
ModifyListenerAttributes
DescribeListeners	新增返回参数： CACertificateSource、PcaRootCACertificateId、PcaSubCACertificateId ，用于展示私有 CA 证书信息。
DescribeListenerAttributes
CreateLoadBalancer	新增请求参数：ClientToken ，用于确保请求幂等性。	负载均衡实例

2025年6月

接口名称	变更记录	关联功能
CreateRules	新增请求参数： MethodConfig ，表示在转发条件中指定的请求方法。 FixedResponseConfig ，表示在转发动作中指定的固定响应。	转发规则
DescribeRules
ModifyRules
CreateServerGroup	新增请求参数：CrossZoneEnabled ，表示“跨可用区负载均衡”功能的配置。新增“跨可用区负载均衡”功能相关的错误码。	服务器组
ModifyServerGroupAttributes
DescribeServerGroups	新增返回参数：CrossZoneEnabled ，表示“跨可用区负载均衡”功能的配置。
DescribeServerGroupAttributes	新增返回参数：CrossZoneEnabled ，表示“跨可用区负载均衡”功能的配置。
AddServerGroupBackendServers	新增“跨可用区负载均衡”功能相关的错误码。
--	ALB 服务接入地址和通信协议更新。详见调用方式文档。服务接入方式变更：原来的全局服务接入地址变更为按地域划分的服务接入地址。通信协议变更：当前只支持 HTTPS。	--

2025年4月

接口名称	变更记录	关联功能
CreateAcl	新增请求参数： Tags 结构，表示访问控制策略组关联的标签。	访问控制
DescribeAcl
DescribeAclAttributes
CreateCustomizedCfg	新增请求参数：Tags ，表示个性化配置关联的标签。修改请求参数：add_header 配置项输入规则更新，value 支持分号（;），满足在特定响应头中指定多个指令或参数的需求。	个性化配置
DescribeCustomizedCfg	新增返回参数：Tags ，表示个性化配置关联的标签。修改返回参数：add_header 配置项输入规则更新，value 支持分号（;），满足在特定响应头中指定多个指令或参数的需求。
DescribeCustomizedCfgAttributes
ModifyCustomizedCfgAttributes	修改请求参数：add_header 配置项输入规则更新，value 支持分号（;），满足在特定响应头中指定多个指令或参数的需求。
CreateHealthCheckTemplate	新增请求参数： Tags 和 ProjectName ，分别表示健康检查模板关联的标签和所属的项目。	健康检查模板
DescribeHealthCheckTemplates	新增返回参数： Tags 和 ProjectName ，分别表示健康检查模板关联的标签和所属的项目。	健康检查模板
UploadCertificate	新增请求参数： Tags ，表示证书关联的标签。	证书
ReplaceCertificate
ReplaceCACertificate
UploadCACertificate
DescribeCACertificates	新增返回参数： Tags ，表示证书关联的标签。
DescribeCertificates
DescribeAllCertificates
DescribeServerGroups	节流限制更新为 “每秒最多提交 40 个 API 请求”。	服务器组

2025年3月

接口名称	变更记录	关联功能
CreateLoadBalancer	新增请求参数： LoadBalancerEdition ，表示 ALB 实例的版本。	负载均衡实例
DescribeLoadBalancers
DescribeLoadBalancerAttributes
CreateRules	新增适用于标准版 ALB 实例的请求参数以及相关错误码。	转发规则
ModifyRules	新增适用于标准版 ALB 实例的请求参数以及相关错误码。
DescribeRules	新增适用于标准版 ALB 实例的返回参数。
DescribeServerGroupBackendServers	新增接口，用于查询指定服务器组内的后端服务器的信息。	服务器组
CreateServerGroup	修改请求参数：Protocol 的取值增加 gRPC，表示 gRPC 可以作为后端通信协议。	服务器组

2024年12月

接口名称	变更记录	关联功能
CloneLoadBalancer	新增接口，用于复制 ALB 实例。	负载均衡实例
ModifyLoadBalancerZones	新增接口，用于修改 ALB 实例的可用区。
CreateLoadbalancer	新增请求参数：ModificationProtectionStatus和ModificationProtectionReason，表示 ALB 实例修改保护功能的配置和开启该功能的原因。新增错误码： OperationDenied.DualStackUnsupported 和OperationDenied.DualStackUnsupported。
ModifyLoadBalancerAttributes
DescribeLoadBalancers	新增返回参数中新增 ModificationProtectionStatus和ModificationProtectionReason。
DescribeLoadBalancerAttributes
CreateListener	新增错误码： Forbidden。	监听器
ModifyListenerAttributes	新增请求参数： AccessLogRecordCustomizedHeadersEnabled，用于配置“在访问日志中记录自定义 header”功能。新增错误码： InvalidLoadBalancer.InvalidStatus。
DescribeListeners	新增返回参数： AccessLogRecordCustomizedHeadersEnabled。
DescribeListenerAttributes	新增返回参数： AccessLogRecordCustomizedHeadersEnabled。
CreateServerGroup	新增请求参数： Protocol，表示向后端服务器转发请求使用的协议。参数值可以是 HTTP 或 HTTPS。 HealthCheck.Port，表示向后端服务器发送请求使用的端口。新增错误码： InvalidProtocol.Malformed。	服务器组
ModifyServerGroupAttributes	新增请求参数： HealthCheck.Port，表示向后端服务器发送请求使用的端口。
DescribeServerGroups	新增返回参数： Protocol 、HealthCheck.Port。
DescribeServerGroupAttributes	新增返回参数： Protocol 、HealthCheck.Port。
DeleteServerGroup	新增错误码： InvalidServerGroupListener.InUse。
CreateHealthCheckTemplates	新增请求参数：HealthCheckTemplates.N.HealthCheckPort，表示向后端服务器发送请求使用的端口。	健康检查模板
ModifyHealthCheckTemplatesAttributes
DescribeHealthCheckTemplates	新增返回参数： HealthCheckPort。
TagResources	修改请求参数：ResourceType 的取值新增 listener 和 servergroup，表示监听器和后端服务器组。	标签
UntagResources
ListTagsForResources	新增接口，用于查询资源绑定的用户标签。

2024年9月

接口名称	变更记录	关联功能
ModifyLoadBalancerAttributes	新增请求参数： WafProtectionEnabled、WafInstanceId、WafProtectedDomain，用于 ALB 启用 WAF 。 GlobalAccelerator相关字段，表示为 ALB 实例启用全球加速时的相关配置。新增错误码。	负载均衡实例
DescribeLoadBalancers	新增返回参数： WafProtectionEnabled、WafInstanceId，用于表示 ALB 实例是否启用 WAF 涉及的字段。
DescribeLoadbalancerAttributes	新增返回参数： WafProtectionEnabled、WafInstanceId，用于表示 ALB 实例是否启用 WAF 涉及的字段。 GlobalAccelerators相关字段，表示查询的 ALB 实例关于全球加速功能的配置信息。 SniAutoMatch，表示实例是否支持自动选择扩展证书。
CreateListener	修改请求参数： DomainExtensions.N.Domain 更新描述：若实例支持自动选择扩展证书，即SniAutoMatch为on，则DomainExtensions.N.Domain需传入空字符串。新增错误码。	监听器
ModifyListenerAttributes		监听器
DescribeListenerAttributes	根据实例是否支持自动选择扩展证书，修改返回参数Domain的说明，新增San返回参数。	证书
DescribeCertificates	新增返回参数San，用于展示证书的扩展域名列表。
DescribeCAcertificate
DescribeAllCertificates
ReplaceCertificate	新增错误码。
CreateCustomizedCfg	新增请求参数：proxy_pass_header，强制透传您选择的后端响应头，该响应头不会被 ALB 相同响应头覆盖。	个性化配置
ModifyCustomizedCfgAttributes	新增请求参数：proxy_pass_header，强制透传您选择的后端响应头，该响应头不会被 ALB 相同响应头覆盖。
DescribeCustomizedCfg	新增返回参数：proxy_pass_header，强制透传您选择的后端响应头，该响应头不会被 ALB 相同响应头覆盖。
DescribeCustomizedCfgAttributes	新增返回参数：proxy_pass_header，强制透传您选择的后端响应头，该响应头不会被 ALB 相同响应头覆盖。

2024年7月

接口名称	变更记录	关联功能
CreateServerGroup	新增请求参数：Tags，创建服务器组时时可为服务器组添加标签。新增错误码：Tag相关错误码。	服务器组
DescribeServerGroups	新增请求参数：TagFilters，查询服务器组列表时允许您通过标签来过滤服务器组。新增返回参数：Tags，查询服务器组的详细信息时，在响应参数中展示服务器组的标签信息。
DescribeServerGroupAttributes	新增返回参数：Tags，查询服务器组的详细信息时，在响应参数中展示服务器组的标签信息。
CreateListener	修改请求参数： DomainExtensions.N.Domain 更新，最新允许小写字母；匹配域名时对大小写不敏感。新增请求参数：Tags，创建监听器时可为监听器添加标签。新增错误码：Tag相关错误码。	监听器
ModifyListenerAttributes	修改请求参数： DomainExtensions.N.Domain 更新，最新允许小写字母；匹配域名时对大小写不敏感。
DescribeListeners	新增请求参数：TagFilters，查询监听器列表时允许您通过标签来过滤监听器。新增返回参数：Tags，查询服务器组的详细信息时，在响应参数中展示服务器组的标签信息。
DescribeListenerAttributes	新增返回参数：Tags，查询指定监听器的详细信息时，在响应参数中展示监听器的标签信息。
CreateRules	修改请求参数： Rules.N.Domain ，最新支持域名的大小写不敏感。新增请求参数： ForwardGroupConfig参数，为监听器添加转发规则时，支持转发至多个服务器组。新增错误码。	转发规则
ModifyRules	新增请求参数： ForwardGroupConfig参数，为监听器添加转发规则时，支持转发至多个服务器组。新增错误码。
DescribeRules	新增返回参数： ForwardGroupConfig 参数，获取指定监听器转发规则列表时，可查询服务器组的配置信息。

2024年6月

接口名称	变更记录	关联功能
CreateHealthCheckTemplates	修改HTTP 协议相关字段的描述。	健康检查模板
DescribeHealthCheckTemplates
ModifyHealthCheckTemplatesAttributes
CreateServerGroup			服务器组
DescribeServerGroups
DescribeServerGroupAttributes
ModifyServerGroupAttributes
--	访问日志投递TOS转为白名单功能。添加一个403错误码，未加白的用户使用日志投递TOS功能时返回403。	访问日志
--	add_header新增可选配置项 always ，使用 always 后，对于所有响应码都会带上新增的自定义响应头。 add_header 新增使用限制，不支持使用重复的头部名称。支持 more_set_input_headers，表示将指定的字段添加到请求头中。	个性化配置

2024年4月

接口名称	变更记录	关联功能
CreateListener	新增如下请求参数： CertificateSource 字段，表示默认服务器证书的来源，仅 HTTPS 监听器生效。 CertCenterCertificateId 字段，表示证书中心的证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。 DomainExtensions.N.CertificateSource 字段，表示默认 sni 证书的来源。 DomainExtensions.N.CertCenterCertificateId 字段，表示证书中心证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。	监听器
ModifyListenerAttributes
DescribeListeners	新增请求参数： Protocol 字段，支持根据监听器协议筛选监听器列表。新增返回参数： CertCenterCertificateId 字段，表示证书中心的证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。 DomainExtensions结构内新增CertificateSource 字段，表示默认 sni 证书来源。 CertCenterCertificateId 字段，表示证书中心证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。
DescribeListenerAttributes	新增返回参数： CertCenterCertificateId 字段，表示证书中心的证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。 CertificateSource 字段，表示默认 sni 证书来源。 CertCenterCertificateId 字段，表示证书中心证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。
ReplaceCertificate	新增请求参数： CertificateSource 字段，用于表示新替换证书的来源。 CertCenterCertificateId 字段，表示证书中心的证书ID。	证书

2024年2月

接口名称	变更记录	关联功能
--	最新支持通过API Explorer在线发起接口调用，无需关注签名生成过程，快速获取调用接口的结果。详情参见各个接口文档。	--

2024年1月

接口名称	变更记录	关联功能
CreateRules	转发规则限速范围调整， TrafficLimitQps 的取值范围由原来的 100～100000 升级为 100～150000。	转发规则
DescribeRules
ModifyRules

最近更新时间：2026.09.16 15:53:44

这个页面对您有帮助吗？

有用

无用