修订记录

2024年1月

第十三次正式发布。本次发布内容：
转发规则限速范围调整， TrafficLimitQps 的取值范围由原来的 100～100000 升级为 100～150000。涉及接口CreateRules、DescribeRules、ModifyRules 。

2023年12月

第十二次正式发布。本次发布内容：

• ALB 错误码更新

  • 实例操作接口错误码更新：DescribeLoadBalancers 接口新增错误码 InvalidEipAddress.Malformed。

• ALB 实例支持公网 IP 筛选

  • DescribeLoadBalancers 支持 EipAddress 字段，您可通过公网 IP 作为条件来筛选 ALB 实例。

• ALB个性化配置参数更新

  • ssl_protocols 取值范围新增 TLSv1.3。ALB支持白名单用户开启 TLSv1.3，如需体验，请提交工单。开启TLSv1.3后，ALB会在您已选择的加密套件基础上默认添加 TLSv1.3 的三个套件，暂不支持您修改TLSv1.3 的套件。

2023年10月

第十一次正式发布。本次发布内容：

• ALB 错误码更新

  • 实例操作接口错误码更新：CreateLoadBalancer 接口新增错误码OperationFailed.AccountBalanceNotEnough；DeleteLoadBalancer 接口新增错误码OperationFailed.EipUsedByBandwidthPackage；ModifyLoadBalancerType接口新增错误码OperationFailed.EipUsedByBandwidthPackage。

  • 服务器组接口错误码更新：CreateServerGroup接口新增错误码InvalidHealthCheck.HttpVersion.Malformed；CreateServerGroup接口新增错误码MissingParameter；ModifyServerGroupAttributes接口新增错误码InvalidHealthCheck.HttpVersion.Malformed；ModifyServerGroupAttributes接口新增错误码MissingParameter。

  • 转发规则接口错误码更新：CreateRules 接口新增错误码InvalidRules.RewriteEnabled.Malformed、InvalidRules.RewriteConfig.RewritePath.Malformed、OperationDenied.RewriteEnabledInRedirectAction、Forbidden；ModifyRules接口新增错误码InvalidRules.RewriteEnabled.Malformed、InvalidRules.RewriteConfig.RewritePath.Malformed、OperationDenied.RewriteEnabledInRedirectAction、Forbidden。

  • 健康检查错误码更新：CreateHealthCheckTemplates新增错误码InvalidHealthCheckTemplates.HealthCheckHttpVersion.Malformed、MissingParameter；ModifyHealthCheckTemplatesAttributes接口新增错误码InvalidHealthCheckTemplates.HealthCheckHttpVersion.Malformed、MissingParameter。

• ALB支持配置重写转发规则功能。

  • CreateRules 接口新增 Rules.N.RewriteEnabled 字段，表示重写功能开关；新增 Rules.N.RewriteConfig 字段，用于指定具体的重写配置。

  • DescribeRules 接口新增 RewriteEnabled 字段，表示重写功能开关；新增 RewriteConfig 字段，表示具体的重写配置。

  • ModifyRules 接口新增 Rules.N.RewriteEnabled 字段，表示重写功能开关；新增 Rules.N.RewriteConfig 字段，用于指定具体的重写配置。

• ALB健康检查协议支持HTTP1.1。

  • 服务器组接口

    • CreateServerGroup 接口新增 HealthCheck.HttpVersion 字段，表示创建服务器组，开启健康检查时选择的HTTP协议版本。

    • DescribeServerGroups 返回响应新增 HealthCheck.HttpVersion 字段，表示查询服务器组列表，开启健康检查时选择的哪一个HTTP协议版本。

    • DescribeServerGroupAttributes 返回响应新增 HealthCheck.HttpVersion 字段，表示查询服务器组的详细信息时，查看开启健康检查后选择的哪一个HTTP协议版本。

    • ModifyServerGroupAttributes 接口新增 HealthCheck.HttpVersion 字段，表示修改指定服务器组详细信息时，修改健康检查HTTP协议版本。

  • 健康检查接口

    • CreateHealthCheckTemplates 接口新增 HealthCheckTemplates.N.HealthCheckHttpVersion 字段，表示创建健康检查模板时使用的HTTP协议版本。

    • DescribeHealthCheckTemplates接口返回响应新增 HealthCheckHttpVersion字段，表示获取健康检查模板列表时，模板使用的HTTP协议版本。

    • ModifyHealthCheckTemplatesAttributes接口新增HealthCheckTemplates.N.HealthCheckHttpVersion 字段，表示修改健康检查模板时，使用的HTTP协议版本。

• ALB个性化配置支持更多参数。

  • ssl session 过期时间（ssl_session_timeout）。

  • 后端响应缓存区大小（proxy_buffer_size）。

  • 客户端请求大标头缓存区（large_client_header_buffers）。

  • client_max_body_size 新配置范围。

2023年8月

第十次正式发布。本次发布内容：

• ALB支持 Project 功能 。更新相关接口如下：

  • 修订实例操作接口。

    • CreateLoadBalancer 接口新增 ProjectName 请求参数，表示创建实例时绑定的项目。

    • DescribeLoadBalancers 接口新增 ProjectName 请求/返回参数，表示查询实例列表时项目过滤条件，以及返回内容中实例所属项目。

    • DescribeLoadBalancerAttributes 接口新增 ProjectName 返回参数，表示实例所属项目。

  • 修订监听器接口。

    • DescribeListeners 接口新增 ProjectName 请求/返回参数，表示查询监听器列表时项目过滤条件，以及返回内容中监听器所属项目。

    • DescribeListenerHealth 接口新增 ProjectName 请求参数，表表示查询监听器健康检查时项目过滤条件。

    • DescribeListenerAttributes 接口新增 ProjectName 返回参数，表示监听器所属项目。

  • 修订服务器组接口。

    • CreateServerGroup 接口新增 ProjectName 请求参数，表示创建后端服务器组时绑定的项目。

    • DescribeServerGroups 接口新增 ProjectName 请求/返回参数，表示查询后端服务器组列表时项目过滤条件，以及返回内容中后端服务器组所属项目。

    • DescribeServerGroupAttributes 接口新增 ProjectName 返回参数，表示后端服务器组所属项目。

  • 修订证书接口。

    • UploadCertificate 接口新增 ProjectName 请求参数，表示上传证书时绑定的项目。

    • UploadCACertificate 接口新增 ProjectName 请求参数，表示上 CA 传证书时绑定的项目。

    • DescribeCertificates 接口新增 ProjectName 请求/返回参数，表示查询证书列表时项目过滤条件，以及返回内容中证书所属项目。

    • DescribeCACertificates 接口新增 ProjectName 请求/返回参数，表示查询 CA 证书列表时项目过滤条件，以及返回内容中 CA 证书所属项目。

  • 修订访问控制接口。

    • CreateAcl 接口新增 ProjectName 请求参数，表示创建 acl 时绑定的项目。

    • DescribeAcls 接口新增 ProjectName 请求/返回参数，表示查询 acl 列表时项目过滤条件，以及返回内容中 acl 所属项目。

    • DescribeAclAttributes 接口新增 ProjectName 返回参数，表示 acl 所属项目。

  • 修订个性化配置接口。

    • CreateCustomizedCfg 接口新增 ProjectName 请求参数，表示创建个性化配置时绑定的项目。

    • DescribeCustomizedCfgs 接口新增 ProjectName 请求/返回参数，表示查询个性化配置列表时项目过滤条件，以及返回内容中个性化配置所属项目。

    • DescribeCustomizedCfgAttributes 接口新增 ProjectName 返回参数，表示个性化配置所属项目。

• 更新 ALB 公共错误码、各个接口新增自有错误码。

• ALB 支持 tag 功能。

  • 新增加 TagResources 接口，为资源添加用户标签。

  • 新增加 UntagResources 接口，为资源删除用户标签。

  • 修订 CreateLoadBalancer 接口，新增 Tags 请求参数，表示实例要绑定的标签列表。

  • 修订 DescribeLoadBalancers 接口，新增 TagFilters 请求参数，表示标签过滤条件，新增加 Tags 返回参数，表示实例绑定的标签。

  • 修订 DescribeLoadBalancerAttributes 接口，新增 Tags 返回参数，表示实例绑定的标签。

2023年5月

第九次正式发布。本次发布内容：

• 修订实例操作接口，ALB支持实例删除保护功能。

  • 修订 CreateLoadBalancer 接口，新增 DeleteProtection 字段，用于创建实例时，是否开启删除保护功能。

  • 修订 ModifyLoadBalancerAttributes 接口，新增 DeleteProtection 字段，用于更新实例时，是否开启删除保护功能。

  • 修订 DescribeLoadBalancers 接口，响应正文中新增 DeleteProtection 字段，表示ALB 实例的删除保护功能为开启或关闭状态。

  • 修订 DescribeLoadBalancerAttributes 接口，响应正文中新增 DeleteProtection 字段，表示ALB 实例的删除保护功能为开启或关闭状态。

• 修订实例操作接口，ALB实例的 IP 类型支持 IPv4&IPv6 双栈类型。

  • 修订 CreateLoadBalancer 接口。

    • 新增 AddressIpVersion 字段，表示 ALB实例的 IP 类型。

    • 新增 Ipv6EipBillingConfig.ISP 字段，表示创建 IPv4&IPv6 双栈类型的公网 ALB 实例时，公网ALB 实例的 IPv6 公网带宽的线路类型。

    • 新增 Ipv6EipBillingConfig.BillingType 字段，表示 公网ALB 实例的 IPv6 公网带宽的计费类型。

    • 新增 Ipv6EipBillingConfig.Bandwidth 字段，表示公网ALB 实例的 IPv6 公网带宽的带宽上限。

  • 修订 DescribeLoadBalancers 接口。

    • 新增 AddressIpVersion 字段，表示 ALB实例的 IP 类型。

    • 新增 EniIpv6Address 字段，表示 IPv4&IPv6 双栈类型的 ALB 实例在该可用区的 IPv6 地址。

    • 新增 Ipv6EipId 字段，表示IPv4&IPv6 双栈类型的 ALB 公网实例，在该可用区的 IPv6 公网带宽 ID。

    • 新增 Ipv6Eip 字段，表示 IPv4&IPv6 双栈类型的 ALB 公网实例，在该可用区的 IPv6 公网带宽的信息。

  • 修订 DescribeLoadBalancerAttributes 接口。

    • 新增 AddressIpVersion 字段，表示 ALB实例的 IP 类型。

    • 新增 EniIpv6Address 字段，表示 IPv4&IPv6 双栈类型的 ALB 实例在该可用区的 IPv6 地址。

    • 新增 Ipv6EipId 字段，表示IPv4&IPv6 双栈类型的 ALB 公网实例，在该可用区的 IPv6 公网带宽 ID。

    • 新增 Ipv6Eip 字段，表示 IPv4&IPv6 双栈类型的 ALB 公网实例，在该可用区的 IPv6 公网带宽的信息。

2023年4月

第八次正式发布。本次发布内容：

• 修订转发规则接口。转发规则支持 QPS 限速。

  • 修订 CreateRules 接口，新增 Rules.N.TrafficLimitEnabled 字段，表示 QPS 限速开关；新增 Rules.N.TrafficLimitQPS 字段，用于指定具体的 QPS 限速值。

  • 修订 DescribeRules 接口，新增 TrafficLimitEnabled 字段，表示 QPS 限速开关的状态；新增 TrafficLimitQPS 字段，表示具体的 QPS 限速值。

  • 修订 ModifyRules 接口，新增 Rules.N.TrafficLimitEnabled 字段，表示 QPS 限速开关；新增 Rules.N.TrafficLimitQPS 字段，用于更新具体的 QPS 限速值。

2023年3月

第七次正式发布。本次发布内容：

• 修订实例操作接口，私网 ALB 实例绑定公网IP时，支持绑定 Anycast 公网IP。

  • 修订 ModifyLoadBalancerType 接口，新增 ZoneMappings.N.EipType 字段，用于表示绑定公网IP的类型；新增 ZoneMappings.N.PopLocations 字段，用于绑定Anycast 公网IP 类型时，指定接入点。

  • 修订 DescribeLoadBalancerAttributes 接口，新增 EipType 字段，表示ALB实例上的公网IP类型；新增 AssociationMode 字段，表示 ALB 作为 Anycast公网IP的源站时源站的类型；新增 PopLocations 字段，展示ALB 作为 Anycast 公网IP的源站时，关联的接入点信息。

  • 修订 DescribeLoadBalancer 接口，新增 EipType 字段，表示ALB实例上的公网IP类型；新增 AssociationMode 字段，表示 ALB 作为 Anycast公网IP的源站时源站的类型；新增 PopLocations 字段，展示ALB 作为 Anycast 公网IP的源站时，关联的接入点信息。

• 更新证书接口。支持查询所有证书列表；支持为指定服务器证书所关联的监听器一键替换成新的服务器证书、为CA证书所关联的监听器一键替换成新的CA证书。

  • 新增 DescribeAllCertificates 接口，用于查询所有证书列表。

  • 新增 ReplaceCertificate 接口，用于替换服务器证书。

  • 新增 ReplaceCACertificate 接口，用于替换CA证书。

2023年2月

第六次正式发布。本次发布内容：

• 更新访问日志接口，支持访问日志投递TLS。

  • 新增EnableTLSAccessLog接口，用于开启访问日志投递TLS。

  • 新增DisableTLSAccessLog接口，用于关闭访问日志投递TLS。

• 新增变更ALB实例类型 ModifyLoadBalancerType接口，ALB支持变更实例网络类型。

2022年12月

第五次正式发布。本次发布内容：
修订实例操作接口，在创建 ALB 公网实例时支持选择增强型公网IP。

• 修订CreateLoadBalancer接口，新增 EipBillingConfig.SecurityProtectionTypes字段，用于指定公网IP的防护资源。

• 修订DescribeLoadBalancer接口新增SecurityProtectionTypes字段，用于展示公网IP关联的防护资源。

• 修订DescribeLoadBalancerAttributes接口新增SecurityProtectionTypes字段，用于展示公网IP关联的防护资源。

2022年11月

第四次正式发布。 本次发布内容：

• 修订服务器组接口，新增会话保持 StickySessionConfig 字段，涉及 CreateServerGroup、ModifyServerGroupAttributes 、DescribeServerGroups、DescribeServerGroupAttributes 接口。

• 修订实例操作中 CreateLoadBalancer 接口，新增 BandwidthPackageId 字段，用于指定 ALB 公网实例需要加入的带宽包ID。

• 新增证书 UploadCACertificate、DeleteCACertificate、DescribeCACertificates和ModifyCACertificate 4个 CA 证书相关接口。

• 修订监听器接口，新增CA证书 CACertificateId 字段，支持双向认证。涉及CreateListener、ModifyListenerAttributes、DescribeListeners、DescribeListenerAttributes 接口。

• 修订个性化配置接口，更新 CustomizedCfgContent 字段，增加个性化配置项。涉及 CreateCustomizedCfg、ModifyCustomizedCfgAttributes、DescribeCustomizedCfgs、DescribeCustomizedCfgAttributes 接口。

2022年9月

第三次正式发布。 本次发布内容：

• 新增可用区 Zone 接口。

• 修订服务器组接口，支持通过 eni 添加后端服务器，涉及 DescribeServerGroupAttributes、AddServerGroupBackendServers 接口。

• 修订实例操作中 CreateLoadBalancer 接口，即将下线 SubnetId 字段，新增 ZoneMappings 字段，指定需要部署的可用区和子网信息。

• 修订实例操作中 DescribeLoadBalancerAttributes、DescribeLoadBalancers 接口，即将下线 SubnetId、EipId、EipAddress、EniId、EniAddress、Eip（外层）字段，新增 DNSName、ZoneMappings 字段，展示域名及 ALB 实例部署的可用区信息 。

2022年7月

第二次正式发布。 本次发布内容：

• 新增个性化配置 CustomizedCfg 接口。

• 新增健康检查日志 HealthLog 接口。

• 修订转发规则接口，新增重定向转发规则字段，涉及 CreateRules、ModifyRules、DescribeRules 接口。

• 修订监听相关接口，新增个性化配置字段，涉及 ModifyListenerAttributes、DescribeListeners、DescribeListenerAttributes 接口。

• 修订证书接口，ModifyCertificateAttributes 接口支持修改证书的描述。