## 2026年1月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[ModifyServerGroupBackendServers](https://www.volcengine.com/docs/6406/113814) |新增请求参数：Servers.N.InstanceId，表示ECS实例的ID。 |后端服务器组 | |[CreateListener](https://www.volcengine.com/docs/6406/113661) |新增请求参数：XRealIpEnabled，表示监听器开启或禁用获取客户端源IP。|监听器 |\ | | | | |[ModifyListenerAttributes](https://www.volcengine.com/docs/6406/113683) |^^|^^| |[DescribeListeners](https://www.volcengine.com/docs/6406/113684) |新增返回参数：XRealIpEnabled，表示监听器开启或禁用获取客户端源IP。|^^|\ | | | | |[DescribeListenerAttributes](https://www.volcengine.com/docs/6406/113686) |^^|^^| |[DescribeRules](https://www.volcengine.com/docs/6406/113976) |新增返回参数：RedirectDomain，表示重定向域名。|转发规则|\ | | | | |[DeleteRules](https://www.volcengine.com/docs/6406/113978) |^^|^^| |[ModifyRules](https://www.volcengine.com/docs/6406/113977) |新增请求参数：Rules.N.RedirectConfig.RedirectDomain，表示重定向域名。 |^^| |[CreateRules](https://www.volcengine.com/docs/6406/113975) |^^|^^| ## 2025年7月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateRules](/docs/6406/113975) |* 修改请求参数：`TrafficLimitQps` 、`TrafficLimitConfig.QPS` 的取值范围由 100~150000 调整为 100~400000。|转发规则 |\ | |* 新增请求参数：`QueryStringConfig` ，用于在转发条件中指定查询字符串。 | | |[ModifyRules](/docs/6406/113977) |^^|^^| |[DescribeRules](/docs/6406/113976) |新增返回参数： `QueryStringConfig` ，表示在转发条件中指定的查询字符串。 |^^| |[CreateListener](/docs/6406/113661) |* 新增请求参数： |监听器 |\ | | * `CACertificateSource` ，用于指定 CA 证书来源。| |\ | | * `PcaRootCACertificateId` ，用于指定私有根 CA 证书作为 CA 证书。| |\ | | * `PcaSubCACertificateId` ，用于指定私有子 CA 证书作为 CA 证书。| |\ | |* 新增私有 CA 证书相关的错误码。 | | |[ModifyListenerAttributes](/docs/6406/113683) |^^|^^| |[DescribeListeners](/docs/6406/113684) |新增返回参数： `CACertificateSource`、`PcaRootCACertificateId`、`PcaSubCACertificateId` ，用于展示私有 CA 证书信息。 |^^| |[DescribeListenerAttributes](/docs/6406/113686) |^^|^^| |[CreateLoadBalancer](/docs/6406/113589) |新增请求参数：`ClientToken` ，用于确保请求幂等性。 |负载均衡实例 | ## 2025年6月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateRules](/docs/6406/113975) |* 新增请求参数： |转发规则 |\ | | * `MethodConfig` ，表示在转发条件中指定的请求方法。| |\ | | * `FixedResponseConfig` ，表示在转发动作中指定的固定响应。 | | |[DescribeRules](/docs/6406/113976) |^^|^^| |[ModifyRules](/docs/6406/113977) |^^|^^| |[CreateServerGroup](/docs/6406/113808) |* 新增请求参数：`CrossZoneEnabled` ，表示“跨可用区负载均衡”功能的配置。|服务器组 |\ | |* 新增“跨可用区负载均衡”功能相关的错误码。 | | |[ModifyServerGroupAttributes](/docs/6406/113812) |^^|^^| |[DescribeServerGroups](/docs/6406/113810) |新增返回参数：`CrossZoneEnabled` ，表示“跨可用区负载均衡”功能的配置。 |^^| |[DescribeServerGroupAttributes](/docs/6406/113811) |^^|^^| |[AddServerGroupBackendServers](/docs/6406/113813) |新增“跨可用区负载均衡”功能相关的错误码。 |^^| |\-\- |ALB 服务接入地址和通信协议更新。详见[调用方式](/docs/6406/113575)文档。|\-\- |\ | || |\ | |* 服务接入方式变更：原来的全局服务接入地址变更为按地域划分的服务接入地址。| |\ | |* 通信协议变更：当前只支持 HTTPS。 | | ## 2025年4月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateAcl](/docs/6406/113731) |新增请求参数： `Tags` 结构，表示访问控制策略组关联的标签。 |访问控制 | |[DescribeAcl](/docs/6406/113734) |^^|^^| |[DescribeAclAttributes](/docs/6406/113735) |^^|^^| |[CreateCustomizedCfg](/docs/6406/123763) |* 新增请求参数：`Tags` ，表示个性化配置关联的标签。|个性化配置 |\ | |* 修改请求参数：add_header 配置项输入规则更新，value 支持分号（;），满足在特定响应头中指定多个指令或参数的需求。 | | |[DescribeCustomizedCfg](/docs/6406/123770) |* 新增返回参数：`Tags` ，表示个性化配置关联的标签。|^^|\ | |* 修改返回参数：add_header 配置项输入规则更新，value 支持分号（;），满足在特定响应头中指定多个指令或参数的需求。 | | |[DescribeCustomizedCfgAttributes](/docs/6406/123771) |^^|^^| |[ModifyCustomizedCfgAttributes](/docs/6406/123766) |修改请求参数：add_header 配置项输入规则更新，value 支持分号（;），满足在特定响应头中指定多个指令或参数的需求。 |^^| |[CreateHealthCheckTemplate](/docs/6406/113795) |新增请求参数： `Tags` 和 `ProjectName` ，分别表示健康检查模板关联的标签和所属的项目。 |健康检查模板 | |[DescribeHealthCheckTemplates](/docs/6406/113799) |新增返回参数： `Tags` 和 `ProjectName` ，分别表示健康检查模板关联的标签和所属的项目。 |^^| |[UploadCertificate](/docs/6406/113740) |新增请求参数： `Tags` ，表示证书关联的标签。 |证书 | |[ReplaceCertificate](/docs/6406/196770) |^^|^^| |[ReplaceCACertificate](/docs/6406/196771) |^^|^^| |[UploadCACertificate](/docs/6406/153646) |^^|^^| |[DescribeCACertificates](/docs/6406/153649) |新增返回参数： `Tags` ，表示证书关联的标签。 |^^| |[DescribeCertificates](/docs/6406/113743) |^^|^^| |[DescribeAllCertificates](/docs/6406/196772) |^^|^^| |[DescribeServerGroups](/docs/6406/113810) |节流限制更新为 “每秒最多提交 40 个 API 请求”。 |服务器组 | ## 2025年3月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateLoadBalancer](/docs/6406/113589) |新增请求参数： `LoadBalancerEdition` ，表示 ALB 实例的版本。|负载均衡实例 |\ | | | | |[DescribeLoadBalancers](/docs/6406/113594) |^^|^^| |[DescribeLoadBalancerAttributes](/docs/6406/113596) |^^|^^| |[CreateRules](/docs/6406/113975) |新增适用于标准版 ALB 实例的请求参数以及相关错误码。 |转发规则 | |[ModifyRules](/docs/6406/113977) |^^|^^| |[DescribeRules](/docs/6406/113976) |新增适用于标准版 ALB 实例的返回参数。 |^^| |[DescribeServerGroupBackendServers](/docs/6406/1456604) |新增接口，用于查询指定服务器组内的后端服务器的信息。 |服务器组 | |[CreateServerGroup](/docs/6406/113808) |修改请求参数：`Protocol` 的取值增加 gRPC，表示 gRPC 可以作为后端通信协议。 |^^| ## 2024年12月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CloneLoadBalancer](/docs/6406/1387997) |新增接口，用于复制 ALB 实例。 |负载均衡实例 | |[ModifyLoadBalancerZones](/docs/6406/1387998) |新增接口，用于修改 ALB 实例的可用区。 |^^| |[CreateLoadbalancer](/docs/6406/113589) |* 新增请求参数：`ModificationProtectionStatus`和`ModificationProtectionReason`，表示 ALB 实例修改保护功能的配置和开启该功能的原因。|^^|\ | |* 新增错误码： OperationDenied.DualStackUnsupported 和OperationDenied.DualStackUnsupported。 | | |[ModifyLoadBalancerAttributes](/docs/6406/113593) |^^|^^| |[DescribeLoadBalancers](/docs/6406/113594) |新增返回参数中新增 `ModificationProtectionStatus`和`ModificationProtectionReason`。 |^^| |[DescribeLoadBalancerAttributes](/docs/6406/113596) |^^|^^| |[CreateListener](/docs/6406/113661) |新增错误码： Forbidden。 |监听器 | |[ModifyListenerAttributes](/docs/6406/113683) |* 新增请求参数： `AccessLogRecordCustomizedHeadersEnabled`，用于配置“在访问日志中记录自定义 header”功能。|^^|\ | |* 新增错误码： InvalidLoadBalancer.InvalidStatus。 | | |[DescribeListeners](/docs/6406/113684) |新增返回参数： `AccessLogRecordCustomizedHeadersEnabled`。 |^^| |[DescribeListenerAttributes](/docs/6406/113686) |^^|^^| |[CreateServerGroup](/docs/6406/113808) |* 新增请求参数：|服务器组 |\ | | * `Protocol`，表示向后端服务器转发请求使用的协议。参数值可以是 HTTP 或 HTTPS。| |\ | | * `HealthCheck.Port`，表示向后端服务器发送请求使用的端口。| |\ | |* 新增错误码： InvalidProtocol.Malformed。 | | |[ModifyServerGroupAttributes](/docs/6406/113812) |新增请求参数： `HealthCheck.Port`，表示向后端服务器发送请求使用的端口。 |^^| |[DescribeServerGroups](/docs/6406/113810) | 新增返回参数： `Protocol` 、`HealthCheck.Port`。 |^^| |[DescribeServerGroupAttributes](/docs/6406/113811) |^^|^^| |[DeleteServerGroup](/docs/6406/113809) |新增错误码： InvalidServerGroupListener.InUse。 |^^| |[CreateHealthCheckTemplates](/docs/6406/113795) |新增请求参数：`HealthCheckTemplates.N.HealthCheckPort`，表示向后端服务器发送请求使用的端口。 |健康检查模板 | |[ModifyHealthCheckTemplatesAttributes](/docs/6406/113800) |^^|^^| |[DescribeHealthCheckTemplates](/docs/6406/113799) |新增返回参数： HealthCheckPort。 |^^| |[TagResources](/docs/6406/1126558) |修改请求参数：`ResourceType` 的取值新增 listener 和 servergroup，表示监听器和后端服务器组。 |标签 | |[UntagResources](/docs/6406/1126559) |^^|^^| |[ListTagsForResources](/docs/6406/1388011) |新增接口，用于查询资源绑定的用户标签。 |^^| ## 2024年9月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[ModifyLoadBalancerAttributes](/docs/6406/113593) |* 新增请求参数：|负载均衡实例 |\ | | * `WafProtectionEnabled`、`WafInstanceId`、`WafProtectedDomain`，用于 ALB 启用 WAF 。| |\ | | * `GlobalAccelerator`相关字段，表示为 ALB 实例启用全球加速时的相关配置。| |\ | |* 新增错误码。 | | |[DescribeLoadBalancers](/docs/6406/113594) |新增返回参数： `WafProtectionEnabled`、`WafInstanceId`，用于表示 ALB 实例是否启用 WAF 涉及的字段。 |^^| |[DescribeLoadbalancerAttributes](/docs/6406/113596) |新增返回参数： |^^|\ | || |\ | |* `WafProtectionEnabled`、`WafInstanceId`，用于表示 ALB 实例是否启用 WAF 涉及的字段。| |\ | |* `GlobalAccelerators`相关字段，表示查询的 ALB 实例关于全球加速功能的配置信息。| |\ | |* `SniAutoMatch`，表示实例是否支持自动选择扩展证书。 | | |[CreateListener](/docs/6406/113661) |* 修改请求参数： `DomainExtensions.N.Domain` 更新描述：若实例支持自动选择扩展证书，即`SniAutoMatch`为`on`，则`DomainExtensions.N.Domain`需传入空字符串。|监听器 |\ | |* 新增错误码。 | | |[ModifyListenerAttributes](/docs/6406/113683) |^^|^^| |[DescribeListenerAttributes](/docs/6406/113686) |根据实例是否支持自动选择扩展证书，修改返回参数`Domain`的说明，新增`San`返回参数。 |证书 | |[DescribeCertificates](/docs/6406/113743) |新增返回参数`San`，用于展示证书的扩展域名列表。 |^^| |[DescribeCAcertificate](/docs/6406/153649) |^^|^^| |[DescribeAllCertificates](/docs/6406/196772) |^^|^^| |[ReplaceCertificate](/docs/6406/196770) |新增错误码。 | | |[CreateCustomizedCfg](/docs/6406/123763) |新增请求参数：`proxy_pass_header`，强制透传您选择的后端响应头，该响应头不会被 ALB 相同响应头覆盖。 |个性化配置 | |[ModifyCustomizedCfgAttributes](/docs/6406/123766) |^^|^^| |[DescribeCustomizedCfg](/docs/6406/123770) |新增返回参数：`proxy_pass_header`，强制透传您选择的后端响应头，该响应头不会被 ALB 相同响应头覆盖。 |^^| |[DescribeCustomizedCfgAttributes](/docs/6406/123771) |^^|^^| ## 2024年7月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateServerGroup](/docs/6406/113808) |* 新增请求参数：`Tags`，创建服务器组时时可为服务器组添加标签。|服务器组 |\ | |* 新增错误码：Tag相关错误码。 | | |[DescribeServerGroups](/docs/6406/113810) |* 新增请求参数：`TagFilters`，查询服务器组列表时允许您通过标签来过滤服务器组。|^^|\ | |* 新增返回参数：`Tags`，查询服务器组的详细信息时，在响应参数中展示服务器组的标签信息。 | | |[DescribeServerGroupAttributes](/docs/6406/113811) |新增返回参数：`Tags`，查询服务器组的详细信息时，在响应参数中展示服务器组的标签信息。 |^^| |[CreateListener](/docs/6406/113661) |* 修改请求参数： `DomainExtensions.N.Domain` 更新，最新允许小写字母；匹配域名时对大小写不敏感。|监听器 |\ | |* 新增请求参数：`Tags`，创建监听器时可为监听器添加标签。| |\ | |* 新增错误码：Tag相关错误码。 | | |[ModifyListenerAttributes](/docs/6406/113683) |修改请求参数： `DomainExtensions.N.Domain` 更新，最新允许小写字母；匹配域名时对大小写不敏感。 |^^| |[DescribeListeners](/docs/6406/113684) |* 新增请求参数：`TagFilters`，查询监听器列表时允许您通过标签来过滤监听器。|^^|\ | |* 新增返回参数：`Tags`，查询服务器组的详细信息时，在响应参数中展示服务器组的标签信息。 | | |[DescribeListenerAttributes](/docs/6406/113686) |新增返回参数：`Tags`，查询指定监听器的详细信息时，在响应参数中展示监听器的标签信息。 |^^| |[CreateRules](/docs/6406/113975) |* 修改请求参数： `Rules.N.Domain` ，最新支持域名的大小写不敏感。|转发规则 |\ | |* 新增请求参数： `ForwardGroupConfig`参数，为监听器添加转发规则时，支持转发至多个服务器组。| |\ | |* 新增错误码。 | | |[ModifyRules](/docs/6406/113977) |* 新增请求参数： `ForwardGroupConfig`参数，为监听器添加转发规则时，支持转发至多个服务器组。|^^|\ | |* 新增错误码。 | | |[DescribeRules](/docs/6406/113976) |新增返回参数： `ForwardGroupConfig` 参数，获取指定监听器转发规则列表时，可查询服务器组的配置信息。 |^^| ## 2024年6月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateHealthCheckTemplates](/docs/6406/113795) |修改HTTP 协议相关字段的描述。 |健康检查模板 | |[DescribeHealthCheckTemplates](/docs/6406/113799) |^^|^^| |[ModifyHealthCheckTemplatesAttributes](/docs/6406/113800) |^^|^^| |[CreateServerGroup](/docs/6406/113808) |^^|服务器组 | |[DescribeServerGroups](/docs/6406/113810) |^^|^^| |[DescribeServerGroupAttributes](/docs/6406/113811) |^^|^^| |[ModifyServerGroupAttributes](/docs/6406/113812) |^^|^^| |\-\- |* 访问日志投递TOS转为白名单功能。|访问日志 |\ | |* 添加一个403错误码，未加白的用户使用日志投递TOS功能时返回403。 | | |\-\- |* add_header新增可选配置项 always ，使用 always 后，对于所有响应码都会带上新增的自定义响应头。|个性化配置 |\ | |* add_header 新增使用限制，不支持使用重复的头部名称。| |\ | |* 支持 more_set_input_headers，表示将指定的字段添加到请求头中。 | | ## 2024年4月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateListener](/docs/6406/113661) |新增如下请求参数：|监听器 |\ | || |\ | |* `CertificateSource` 字段，表示默认服务器证书的来源，仅 HTTPS 监听器生效。| |\ | |* `CertCenterCertificateId` 字段，表示证书中心的证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。| |\ | |* `DomainExtensions.N.CertificateSource` 字段，表示默认 sni 证书的来源。| |\ | |* `DomainExtensions.N.CertCenterCertificateId` 字段，表示证书中心证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。 | | |[ModifyListenerAttributes](/docs/6406/113683) |^^|^^| |[DescribeListeners](/docs/6406/113684) |* 新增请求参数： `Protocol` 字段，支持根据监听器协议筛选监听器列表。|^^|\ | |* 新增返回参数：| |\ | | * `CertificateSource` 字段，表示默认服务器证书的来源，仅 HTTPS 监听器生效。| |\ | | * `CertCenterCertificateId` 字段，表示证书中心的证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。| |\ | | * `CertificateSource` 字段，表示默认 sni 证书来源。| |\ | | * `CertCenterCertificateId` 字段，表示证书中心证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。 | | |[DescribeListenerAttributes](/docs/6406/113686) |新增返回参数：|^^|\ | || |\ | |* `CertificateSource` 字段，表示默认服务器证书的来源，仅 HTTPS 监听器生效。| |\ | |* `CertCenterCertificateId` 字段，表示证书中心的证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。| |\ | |* `CertificateSource` 字段，表示默认 sni 证书来源。| |\ | |* `CertCenterCertificateId` 字段，表示证书中心证书 ID，仅 HTTPS 监听器且证书来源为证书中心时生效。 | | |[ReplaceCertificate](/docs/6406/196770) |新增请求参数：|证书 |\ | || |\ | |* `CertificateSource` 字段，用于表示新替换证书的来源。| |\ | |* `CertCenterCertificateId` 字段，表示证书中心的证书ID。 | | ## 2024年2月 |接口名称 |变更记录 |关联功能 | |---|---|---| |\-\- |最新支持通过API Explorer在线发起接口调用，无需关注签名生成过程，快速获取调用接口的结果。详情参见各个接口文档。 |\-\- | ## 2024年1月 |接口名称 |变更记录 |关联功能 | |---|---|---| |[CreateRules](/docs/6406/113975) |转发规则限速范围调整， TrafficLimitQps 的取值范围由原来的 100～100000 升级为 100～150000。 |转发规则 | |[DescribeRules](/docs/6406/113976) |^^|^^| |[ModifyRules](/docs/6406/113977) |^^|^^| ##