Aggregate cluster configuration

This documentation is for the Envoy v3 API.

As of Envoy v1.18 the v2 API has been removed and is no longer supported.

If you are upgrading from v2 API config you may wish to view the v2 API documentation:


[extensions.clusters.aggregate.v3.ClusterConfig proto]

Configuration for the aggregate cluster. See the architecture overview for more information.

This extension may be referenced by the qualified name envoy.clusters.aggregate


This extension is not hardened and should only be used in deployments where both the downstream and upstream are trusted.


This extension extends and can be used with the following extension category:

  "clusters": []

(repeated string, REQUIRED) Load balancing clusters in aggregate cluster. Clusters are prioritized based on the order they appear in this list.