管理 Cloud Router 路由器

本文档介绍了如何列出、更新、获取其状态和删除 Cloud Router 路由器。

准备工作

gcloud

如果您要使用本指南中的命令行示例，请执行以下操作：

  1. 安装或更新到 Google Cloud CLI 的最新版本。
  2. 设置默认区域和可用区。

API

如果希望使用本指南中的 API 示例，请设置 API 访问权限。

列出 Cloud Router 路由器

如需列出项目中的所有 Cloud Router 路由器，请按照以下步骤操作。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Router 页面。

    前往“Cloud Router 路由器”

  2. 在 Cloud Routers 页面上，查看 Cloud Router 路由器列表。

gcloud

运行 list 命令。如果您只想列出一个区域中的路由器，请指定 --filter="region:(<var>REGION</var>)。

  gcloud compute routers list \
      --project=PROJECT_ID \
      [--filter="region:(REGION)]

替换以下内容：

  • PROJECT_ID：您要为其列出 Cloud Router 路由器的项目的 ID
  • REGION：要为其列出路由器的区域，例如 asia-east1

输出内容类似如下：

  NAME        REGION       NETWORK
  my-router   asia-east1   my-network

API

使用 routers.aggregatedList 方法：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/routers

将 PROJECT_ID 替换为您要为其列出 Cloud Router 路由器的项目的 ID。

如需仅列出特定区域中的 Cloud Router 路由器，请使用 routers.list 方法。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers

替换以下内容：

  • PROJECT_ID：您要为其列出 Cloud Router 路由器的项目的 ID
  • REGION：您要为其列出 Cloud Router 路由器的区域

更新 Cloud Router 路由器

如果 Cloud Router 路由器与 NCC 网关相关联，请注意以下事项：

  • 您无法更新 ncc_gateway 字段。

  • patch 或 update 方法不接受 network 字段作为请求正文的一部分。

gcloud

使用 gcloud compute routers update 命令：

gcloud compute routers update ROUTER_NAME
    --region=REGION

替换以下内容：

  • ROUTER_NAME：您要更新的 Cloud Router 路由器的名称
  • REGION：Cloud Router 路由器所在的区域

API

使用 routers.update 方法：

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

替换以下内容：

  • PROJECT_ID：您要为其列出 Cloud Router 路由器的项目的 ID
  • REGION：Cloud Router 路由器所在的区域
  • ROUTER_NAME：您要更新的 Cloud Router 路由器的名称

获取 Cloud Router 路由器状态

gcloud

使用 gcloud compute routers get-status 命令。

gcloud compute routers get-status ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

替换以下内容：

  • ROUTER_NAME：您要获取其状态的 Cloud Router 路由器的名称
  • PROJECT_ID：Cloud Router 路由器所属项目的 ID
  • REGION：Cloud Router 路由器所在的区域

API

将 routers.getRouterStatus 方法与空请求正文搭配使用：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

替换以下内容：

  • PROJECT_ID：Cloud Router 路由器所属项目的 ID
  • REGION：Cloud Router 路由器所在的区域
  • ROUTER_NAME：您要获取其状态的 Cloud Router 路由器的名称

删除 Cloud Router 路由器

在删除 Cloud Router 路由器之前，请先检查该路由器是否未被其他资源（例如 Cloud VPN 隧道或 VLAN 连接）使用。您必须先删除关联的资源，然后才能删除 Cloud Router 路由器。不过，在您删除 Cloud Router 路由器之前不需要移除 BGP 会话。

要删除 Cloud Router 路由器，请按以下步骤操作。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Router 页面。

    前往“Cloud Router 路由器”

  2. 选中您要删除的 Cloud Router 路由器旁边的复选框。

  3. 点击删除。

gcloud

运行 delete 命令。指定您要删除的 Cloud Router 路由器的名称和位置。

gcloud compute routers delete ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

替换以下内容：

  • ROUTER_NAME：您要删除的 Cloud Router 路由器的名称

  • PROJECT_ID：包含您要删除的 Cloud Router 路由器的项目的 ID

  • REGION：Cloud Router 路由器所在的区域

输出类似于以下内容：

Deleted [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/asia-east1/routers/ROUTER_NAME].

API

使用 routers.delete 方法：

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

替换以下内容：

  • PROJECT_ID：包含您要删除的 Cloud Router 路由器的项目的 ID
  • REGION：Cloud Router 路由器所在的区域
  • ROUTER_NAME：Cloud Router 路由器的名称

后续步骤

  • 如需查看 Cloud Router 路由器的配置、其 BGP 会话以及 Cloud Router 路由器要通告的路由，请参阅查看路由器详细信息。
  • 如需排查使用 Cloud Router 时遇到的问题，请参阅问题排查。