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.
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
- For information about how service routing works, read Service routing overview
- For information about the service routing APIs, read the documentation for the network services APIs.