ConfigDump (proto)

admin.v3.UpdateFailureState

{
  "failed_configuration": {...},
  "last_update_attempt": {...},
  "details": ...
}

failed_configuration: (Any) 如果更新成功，元件組態會是什麼樣子。由於儲存開銷，xDS 客戶端可能不會填入此欄位。

last_update_attempt: (Timestamp) 上次更新失敗嘗試的時間。

details: (string) 有關上次更新失敗嘗試的詳細資訊。

admin.v3.ListenersConfigDump

[admin.v3.ListenersConfigDump proto]

Envoy 的監聽器管理器會在此訊息中填入所有目前已知的監聽器。監聽器組態資訊可用於透過將所有監聽器填入為靜態監聽器，或在 LDS 回應中傳回它們來重新建立 Envoy 組態。

{
  "version_info": ...,
  "static_listeners": [],
  "dynamic_listeners": []
}

version_info: (string) 這是上次處理的 LDS 探索回應中的 version_info。如果只有靜態啟動監聽器，此欄位將為「」。

static_listeners: (repeated admin.v3.ListenersConfigDump.StaticListener) 靜態載入的監聽器組態。

dynamic_listeners: (repeated admin.v3.ListenersConfigDump.DynamicListener) 任何預熱、活動或排空監聽器的狀態。

admin.v3.ListenersConfigDump.StaticListener

[admin.v3.ListenersConfigDump.StaticListener proto]

描述靜態載入的監聽器。

{
  "listener": {...},
  "last_updated": {...}
}

listener: (Any) 監聽器組態。

last_updated: (Timestamp) 監聽器上次成功更新的時間戳記。

admin.v3.ListenersConfigDump.DynamicListenerState

[admin.v3.ListenersConfigDump.DynamicListenerState proto]

{
  "version_info": ...,
  "listener": {...},
  "last_updated": {...}
}

version_info: (string) 這是每個資源的版本資訊。此版本目前取自監聽器載入時的 version_info 欄位。未來，API 可能會支援個別的每個監聽器版本。

listener: (Any) 監聽器組態。

last_updated: (Timestamp) 監聽器上次成功更新的時間戳記。

admin.v3.ListenersConfigDump.DynamicListener

[admin.v3.ListenersConfigDump.DynamicListener proto]

描述透過 LDS API 動態載入的監聽器。

{
  "name": ...,
  "active_state": {...},
  "warming_state": {...},
  "draining_state": {...},
  "error_state": {...}
}

name: (string) 此監聽器的名稱或唯一 ID，取自 DynamicListenerState 組態。

active_state: (admin.v3.ListenersConfigDump.DynamicListenerState) 此名稱的任何活動監聽器的監聽器狀態。這些監聽器可用於服務資料平面流量。

warming_state: (admin.v3.ListenersConfigDump.DynamicListenerState) 此名稱的任何預熱監聽器的監聽器狀態。這些監聽器目前正在進行預熱，準備服務資料平面流量。請注意，如果嘗試從組態傾印重新建立 Envoy 組態，則通常應捨棄預熱監聽器。

draining_state: (admin.v3.ListenersConfigDump.DynamicListenerState) 此名稱的任何排空監聽器的監聽器狀態。這些監聽器目前正在進行排空，準備停止服務資料平面流量。請注意，如果嘗試從組態傾印重新建立 Envoy 組態，則通常應捨棄排空監聽器。

error_state: (admin.v3.UpdateFailureState) 如果上次更新失敗則設定，在下次成功更新後清除。error_state 欄位包含此特定資源的已拒絕版本以及原因和時間戳記。對於成功更新或確認的資源，此欄位應為空。

admin.v3.ClustersConfigDump

[admin.v3.ClustersConfigDump proto]

Envoy 的叢集管理器會在此訊息中填入所有目前已知的叢集。叢集組態資訊可用於透過將所有叢集填入為靜態叢集，或在 CDS 回應中傳回它們來重新建立 Envoy 組態。

{
  "version_info": ...,
  "static_clusters": [],
  "dynamic_active_clusters": [],
  "dynamic_warming_clusters": []
}

version_info: (string) 這是上次處理的 CDS 探索回應中的 version_info。如果只有靜態啟動叢集，此欄位將為「」。

static_clusters: (repeated admin.v3.ClustersConfigDump.StaticCluster) 靜態載入的叢集組態。

dynamic_active_clusters: (repeated admin.v3.ClustersConfigDump.DynamicCluster) 動態載入的活動叢集。這些叢集可用於服務資料平面流量。

dynamic_warming_clusters: (repeated admin.v3.ClustersConfigDump.DynamicCluster) 動態載入的預熱叢集。這些叢集目前正在進行預熱，準備服務資料平面流量。請注意，如果嘗試從組態傾印重新建立 Envoy 組態，則通常應捨棄預熱叢集。

admin.v3.ClustersConfigDump.StaticCluster

[admin.v3.ClustersConfigDump.StaticCluster proto]

描述靜態載入的叢集。

{
  "cluster": {...},
  "last_updated": {...}
}

cluster: (Any) 叢集組態。

last_updated: (Timestamp) 叢集上次更新的時間戳記。

admin.v3.ClustersConfigDump.DynamicCluster

[admin.v3.ClustersConfigDump.DynamicCluster proto]

描述透過 CDS API 動態載入的叢集。

{
  "version_info": ...,
  "cluster": {...},
  "last_updated": {...}
}

version_info: (string) 這是每個資源的版本資訊。此版本目前取自叢集載入時的 version_info 欄位。未來，API 可能會支援個別的每個叢集版本。

cluster: (Any) 叢集組態。

last_updated: (Timestamp) 叢集上次更新的時間戳記。

admin.v3.RoutesConfigDump

[admin.v3.RoutesConfigDump proto]

Envoy 的 RDS 實作會在此訊息中填入目前載入的所有路由，如其 RouteConfiguration 物件所述。在啟動組態中定義或在組態監聽器時內嵌定義的靜態路由，與透過 RDS 動態組態的路由分開。路由組態資訊可用於透過將所有路由填入為靜態路由，或在 RDS 回應中傳回它們來重新建立 Envoy 組態。

{
  "static_route_configs": [],
  "dynamic_route_configs": []
}

static_route_configs: (repeated admin.v3.RoutesConfigDump.StaticRouteConfig) 靜態載入的路由組態。

dynamic_route_configs: (repeated admin.v3.RoutesConfigDump.DynamicRouteConfig) 動態載入的路由組態。

admin.v3.RoutesConfigDump.StaticRouteConfig

[admin.v3.RoutesConfigDump.StaticRouteConfig proto]

{
  "route_config": {...},
  "last_updated": {...}
}

route_config: (Any) 路由組態。

last_updated: (Timestamp) 路由上次更新的時間戳記。

admin.v3.RoutesConfigDump.DynamicRouteConfig

[admin.v3.RoutesConfigDump.DynamicRouteConfig proto]

{
  "version_info": ...,
  "route_config": {...},
  "last_updated": {...}
}

version_info: (string) 這是每個資源的版本資訊。此版本目前取自路由組態載入時的 version_info 欄位。

route_config: (Any) 路由組態。

last_updated: (Timestamp) 路由上次更新的時間戳記。

admin.v3.ScopedRoutesConfigDump

[admin.v3.ScopedRoutesConfigDump proto]

Envoy 的範圍 RDS 實作會在此訊息中填入目前載入的所有路由組態範圍 (透過 ScopedRouteConfigurationsSet protos 定義)。此訊息列出與較高階物件 (即 HttpConnectionManager) 內嵌定義的範圍，以及透過 SRDS API 動態取得的範圍。

{
  "inline_scoped_route_configs": [],
  "dynamic_scoped_route_configs": []
}

inline_scoped_route_configs: （重複 admin.v3.ScopedRoutesConfigDump.InlineScopedRouteConfigs）靜態載入的作用域路由配置。

dynamic_scoped_route_configs: （重複 admin.v3.ScopedRoutesConfigDump.DynamicScopedRouteConfigs）動態載入的作用域路由配置。

admin.v3.ScopedRoutesConfigDump.InlineScopedRouteConfigs

[admin.v3.ScopedRoutesConfigDump.InlineScopedRouteConfigs proto]

{
  "name": ...,
  "scoped_route_configs": [],
  "last_updated": {...}
}

name: （字串）指派給作用域路由配置的名稱。

scoped_route_configs: （重複 Any）作用域路由配置。

last_updated: （Timestamp）上次更新作用域路由配置集的時間戳記。

admin.v3.ScopedRoutesConfigDump.DynamicScopedRouteConfigs

[admin.v3.ScopedRoutesConfigDump.DynamicScopedRouteConfigs proto]

{
  "name": ...,
  "version_info": ...,
  "scoped_route_configs": [],
  "last_updated": {...}
}

name: （字串）指派給作用域路由配置的名稱。

version_info: （字串）這是每個資源的版本資訊。此版本目前取自於載入作用域路由配置時的 version_info 欄位。

scoped_route_configs: （重複 Any）作用域路由配置。

last_updated: （Timestamp）上次更新作用域路由配置集的時間戳記。

admin.v3.EndpointsConfigDump

[admin.v3.EndpointsConfigDump proto]

Envoy 的管理介面會使用目前所有已知的端點來填寫此訊息。端點配置資訊可用於透過將所有端點填寫為靜態端點或在 EDS 回應中返回它們來重新建立 Envoy 配置。

{
  "static_endpoint_configs": [],
  "dynamic_endpoint_configs": []
}

static_endpoint_configs: （重複 admin.v3.EndpointsConfigDump.StaticEndpointConfig）靜態載入的端點配置。

dynamic_endpoint_configs: （重複 admin.v3.EndpointsConfigDump.DynamicEndpointConfig）動態載入的端點配置。

admin.v3.EndpointsConfigDump.StaticEndpointConfig

[admin.v3.EndpointsConfigDump.StaticEndpointConfig proto]

{
  "endpoint_config": {...}
}

endpoint_config: （Any）端點配置。

admin.v3.EndpointsConfigDump.DynamicEndpointConfig

[admin.v3.EndpointsConfigDump.DynamicEndpointConfig proto]

{
  "endpoint_config": {...}
}

endpoint_config: （Any）端點配置。

admin.v3.EcdsConfigDump

[admin.v3.EcdsConfigDump proto]

Envoy 的 ECDS 服務會使用目前所有的擴充功能配置來填寫此訊息。擴充功能配置資訊可用於透過將所有擴充功能配置為靜態篩選器或在 ECDS 回應中返回它們，來重新建立 Envoy ECDS 監聽器和 HTTP 篩選器。

{
  "ecds_filters": []
}

ecds_filters: （重複 admin.v3.EcdsConfigDump.EcdsFilterConfig）ECDS 篩選器配置。

admin.v3.EcdsConfigDump.EcdsFilterConfig

[admin.v3.EcdsConfigDump.EcdsFilterConfig proto]

{
  "version_info": ...,
  "ecds_filter": {...},
  "last_updated": {...}
}

version_info: （字串）這是每個資源的版本資訊。此版本目前取自於載入 ECDS 篩選器時的 version_info 欄位。

ecds_filter: （Any）ECDS 篩選器配置。

last_updated: （Timestamp）上次更新 ECDS 篩選器的時間戳記。

列舉 admin.v3.ClientResourceStatus

[admin.v3.ClientResourceStatus proto]

從 xDS 用戶端的角度來看的資源狀態，表示 xDS 用戶端和 xDS 伺服器之間的同步狀態。

UNKNOWN: （預設） 資源狀態不可用/未知。

REQUESTED: 用戶端已要求此資源，但尚未從管理伺服器收到任何更新。用戶端不會使請求失敗，而是會將請求排隊，直到更新到達或用戶端等待資源逾時。

DOES_NOT_EXIST: 用戶端已要求此資源，但伺服器尚未傳送此資源，或先前由伺服器傳送，然後從伺服器提供的資源中移除。如需更多資訊，請參閱「了解何時請求的資源不存在」一節。

ACKED: 用戶端已接收此資源並回覆 ACK。

NACKED: 用戶端已接收此資源並回覆 NACK。