.. _envoy_v3_api_file_envoy/extensions/clusters/aggregate/v3/cluster.proto:

Aggregate cluster configuration
===============================


.. _envoy_v3_api_msg_extensions.clusters.aggregate.v3.ClusterConfig:

extensions.clusters.aggregate.v3.ClusterConfig
----------------------------------------------

`[extensions.clusters.aggregate.v3.ClusterConfig proto] <https://github.com/envoyproxy/envoy/blob/v1.18.4/api/envoy/extensions/clusters/aggregate/v3/cluster.proto#L18>`_

Configuration for the aggregate cluster. See the :ref:`architecture overview
<arch_overview_aggregate_cluster>` for more information.


.. _extension_envoy.clusters.aggregate:

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

.. note::
  

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

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


  - :ref:`envoy.clusters <extension_category_envoy.clusters>`

.. code-block:: json

  {
    "clusters": []
  }

.. _envoy_v3_api_field_extensions.clusters.aggregate.v3.ClusterConfig.clusters:

clusters
  (**repeated** `string <https://developers.google.com/protocol-buffers/docs/proto#scalar>`_, *REQUIRED*) Load balancing clusters in aggregate cluster. Clusters are prioritized based on the order they
  appear in this list.