.. _envoy_v3_api_file_envoy/admin/v3/listeners.proto: Listeners ========= 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: :ref:`admin/v2alpha/listeners.proto ` .. _envoy_v3_api_msg_admin.v3.Listeners: admin.v3.Listeners ------------------ :repo:`[admin.v3.Listeners proto] ` Admin endpoint uses this wrapper for `/listeners` to display listener status information. See :ref:`/listeners ` for more information. .. code-block:: json { "listener_statuses": [] } .. _envoy_v3_api_field_admin.v3.Listeners.listener_statuses: listener_statuses (**repeated** :ref:`admin.v3.ListenerStatus `) List of listener statuses. .. _envoy_v3_api_msg_admin.v3.ListenerStatus: admin.v3.ListenerStatus ----------------------- :repo:`[admin.v3.ListenerStatus proto] ` Details an individual listener's current status. .. code-block:: json { "name": "...", "local_address": "{...}" } .. _envoy_v3_api_field_admin.v3.ListenerStatus.name: name (`string `_) Name of the listener .. _envoy_v3_api_field_admin.v3.ListenerStatus.local_address: local_address (:ref:`config.core.v3.Address `) The actual local address that the listener is listening on. If a listener was configured to listen on port 0, then this address has the port that was allocated by the OS.