List `Route` resources

This document is for mesh administrators using the service routing APIs to configure service meshes.

In the service routing API model, Route resources are attached to Mesh or Gateway resources. In its configuration, the Mesh or Gateway resource references one or more Route resources.

If you are the owner of a Mesh or Gateway resource, you can list the Route resources attached to the Mesh or Gateway.

Each Mesh or Gateway resource has synthetic child collection of RouteView resources. Each RouteView corresponds to a single Route. RouteView objects are created alongside Route objects.

In the following diagram, the RouteView for Gateway A consists of the TCPRoute resources from Project A. The RouteView for Gateway B comprises the HTTPRoute resources from Project B and GRPCRoute resources from Project C.

The relationships among the `Route`, `Routeview`, and `Gateway` resources.
The relationships among the `Route`, `Routeview`, and `Gateway` resources.(click to enlarge)

This feature is scoped to the Mesh or Gateway level. A RouteView for a Gateway or Mesh lists routes attached to that Gateway or Mesh and not all the routes attached to the associated scope.

To list the RouteView resources, issue the follow command:

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

You cannot create, update, or delete RouteView resources. They are created, updated, and deleted when their corresponding Route resources are created, updated, and deleted.

What's next