View the hub route table and routes

This page describes how to use hub route tables and routes.

When you create a hub and configure it to use mesh topology, a single default hub route table is generated. With star topology, one hub route table per group is generated.

Permissions required for this task

To perform this task, you must have been granted the following permissions or the following IAM roles.

Permissions

networkconnectivity.hubRouteTables.list to list hub route tables
networkconnectivity.hubRouteTables.get to view hub route tables

Roles

roles/networkconnectivity.hubAdmin
roles/networkconnectivity.hubViewer

List hub route tables

To get a list of hub route tables, follow these steps.

gcloud

Run the gcloud network-connectivity hubs route-tables list command.

gcloud network-connectivity hubs route-tables list \
    --hub=HUB_NAME

Replace HUB_NAMEwith the name of the hub in your project that you want to list the route table for.

API

Use the networkconnectivity.hubs.routeTables.list method with an empty request body.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/routeTables

Replace the following values:

PROJECT_ID: the project ID of the project that contains the hub
HUB_NAME: the name of the hub for which you want to list the hub route table

View hub route tables

To view details, such as name and description of a Network Connectivity Center route table, follow these steps.

Console

In the Google Cloud console, go to Network Connectivity Center.

Go to Network Connectivity Center
In the project menu, select the project in which you want to view the hub details.
Click the name of the hub that you want to view the hub route table for.
Click the Routes tab.
In the Region section, select the region for which you want to view routes.
Follow these steps depending on the topology that your hub is configured for.
- If you're using mesh topology connectivity, the routes and route details are displayed in the Routes section.
- If you're using star topology connectivity, in the Routes section, change the Spoke group to Center or Edge to see the appropriate route table.

gcloud

Run the gcloud network-connectivity hubs route-tables describe command.

gcloud network-connectivity hubs route-tables describe GROUP_NAME \
    --hub=HUB_NAME

Replace the following:

GROUP_NAME: the name of the group for which you want to view the hub route table. For mesh topology connectivity, there is a single default group; for star topology connectivity, there is a center or edge group.
HUB_NAME: the name of the hub for which you want to view the hub route table

API

Use the networkconnectivity.hubs.routeTables.get method with an empty request body.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/routeTables/NAME

Replace the following values:

PROJECT_ID: the project ID of the project that contains the new hub
HUB_NAME: the name of the hub for which you want to view the hub route table
NAME: the name of the hub route table resource

Manage hub routes

A route resource nested under the hub route table corresponds to a subnet in a VPC spoke that has been exported from the VPC network to the hub.

Permissions required for this task

To perform this task, you must have been granted the following permissions or the following IAM roles.

Permissions

networkconnectivity.hubRoutes.get to view hub routes
networkconnectivity.hubRoutes.list to list hub routes

Roles(one of the following):

roles/networkconnectivity.hubAdmin
roles/networkconnectivity.hubViewer

List hub routes

To see a list of hub routes for a specific region, follow these steps.

Console

In the Google Cloud console, go to the Network Connectivity Center page.

Go to Network Connectivity Center
In the project menu, select the project in which you want to view the hub route details.
Click the name of the hub that you want to view the route details for.
Click the Routes tab.
In the Region section, select the region for which you want to view routes. The route table lists both subnet routes and dynamic routes.

gcloud

Run the gcloud network-connectivity hubs route-tables routes list command.

gcloud network-connectivity hubs route-tables routes list \
    --hub=HUB_NAME \
    --route_table=NAME \
    --effective-location=EFFECTIVE_LOCATION

Replace the following:

HUB_NAME: the name of the hub, such as my-hub
NAME: the name of the hub route table, such as edge-route-table or center-route-table
EFFECTIVE_LOCATION: the location of the hub for which you want to view routes, such as us-central1

API

Use the networkconnectivity.hubs.routeTables.routes.list method with an empty request body.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/routeTables/NAME/routes

Replace the following values:

PROJECT_ID: the project ID of the project that contains the hub
HUB_NAME: the name of the hub
NAME: the name of the hub route table resource

View hub route details

To view the details of a specific hub route, such as route type, destination IP address range, and next hop, follow these steps.

Console

In the Google Cloud console, go to the Network Connectivity Center page.

Go to Network Connectivity Center
In the project menu, select the project in which you want to view the hub route details.
Click the name of the hub that you want to view the route details for.
Click the Routes tab.
Use the Filter field to sort routes by type, IP version, destination IP address range, priority, spoke, or next hop.

gcloud

Run the gcloud network-connectivity hubs route-tables routes describe command.

gcloud network-connectivity hubs route-tables routes describe NAME \
    --hub=HUB_NAME \
    --route_table=ROUTE_TABLE

Replace the following:

NAME: the name or ID of the route that you want to describe. Query the API to get the exact route name by using the gcloud network-connectivity hubs route-tables routes list command.
HUB_NAME: the name of the hub, such as my-hub.
ROUTE_TABLE: the name of the hub route table, such as edge-route-table or center-route-table for star topology connectivity and default-route-table for full mesh topology.

API

Use the networkconnectivity.hubs.routeTables.routes.get method.

  GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/global/hubs/HUB_NAME/routeTables/NAME/routes/ROUTE_NAME

Replace the following values:

PROJECT_ID: the project ID of the project that contains the new hub
HUB_NAME: the name of the hub for which you want to view the hub route table
NAME: the name of the hub route table resource
ROUTE_NAME: the name of the route

What's next

To create hubs and spokes, see Work with hubs and spokes.
To view a list of partners whose solutions are integrated with Network Connectivity Center, see Network Connectivity Center partners.
To find solutions for Router appliance issues, see Troubleshooting.
To get details about API and gcloud commands, see APIs and reference.