列出 `Route` 資源

本文適用於使用服務路由 API 設定服務網格的網格管理員。

在服務路徑 API 模型中，Route 資源會附加至 Mesh 或 Gateway 資源。在設定中，Mesh 或 Gateway 資源會參照一或多個 Route 資源。

如果您是 Mesh 或 Gateway 資源的擁有者，可以列出附加至 Mesh 或 Gateway 的資源。Route

每個 Mesh 或 Gateway 資源都有 RouteView 資源的合成子項集合。每個 RouteView 都會對應到單一 Route。RouteView 物件會與 Route 物件一併建立。

在下圖中，Gateway A 的 RouteView 包含專案 A 的 TCPRoute 資源。Gateway B 的 RouteView 包含專案 B 的 HTTPRoute 資源和專案 C 的 GRPCRoute 資源。

這項功能適用於 Mesh 或 Gateway 層級。RouteView，適用於 Gateway 或 Mesh 清單，其中包含附加至該 Gateway 或 Mesh 的路徑，而非附加至相關聯範圍的所有路徑。

如要列出 RouteView 資源，請發出下列指令：

gcloud alpha network-services route-views list \
    --location=global \
    --[mesh | gateway]=[ MESH_NAME | GATEWAY_NAME ]

如要進一步瞭解 Route 本身，請發出下列指令：

gcloud alpha network-services route-views describe --route-view=ROUTEVIEW_FULLNAME

常見的工作流程是列出 Mesh 或 Gateway 的 RouteViews，然後說明每個項目，全面瞭解附加的路徑。

您無法建立、更新或刪除 RouteView 資源。當對應的 Route 資源建立、更新及刪除時，系統也會建立、更新及刪除這些資源。

疑難排解

如果 route-views 指令無法列出路徑的 RouteViews，例如 Listed 0 items.，或無法列出所有已知路徑：

確認 route-views list 中使用的 Mesh 或 Gateway 分別在 Route 的 meshes 或 gateways 欄位中參照，方法如下：

gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID

gcloud network-services http-routes export my-route --location=global \
      --destination=export.yaml

gcloud network-services http-routes import my-route --location=global \
      --source=export.yaml