IBM Cloud Docs
生成直接链路路由报告

生成直接链路路由报告

您可以生成直接链路及其连接已知的所有路径的报告。 此报告允许您验证期望的路由，查看哪些虚拟连接正在向直接链路提供哪些路由，以及查看接收到的路由的下一个中继段地址详细信息。 如果使用跨帐户 VPC 链接功能，您还可以查看正在通过交叉连接路由器路由哪些前缀或子网。

您可以使用 UI，CLI 或 API 来检索路由报告。

路线报告注意事项

使用检修路线报告时，请查看以下注意事项:

  • 在新的虚拟连接 (VPC，经典或 Transit Gateway) 达到 Active 状态后，请允许 5 分钟通过直接链路了解路径。 在学习所有路由之前生成路由报告将生成部分路由报告。
  • 在 BGP 设置为 Established 状态后，大约 5 分钟后，本地路由才会显示。 直到网关完成供应之后，网关路由才会显示。
  • 如果连接公开 0.0.0.0/0 的路由，那么在计算重叠前缀时将忽略该路由。
  • 每个网关在任何时候只有一个报告可用。 如果生成新报告，那么将删除旧报告。
  • 添加或除去连接后，较旧的路由报告可能不准确。 因此，如果在这些连接中更新路由，那么建议您生成新的路由报告。

使用 UI 生成路由报告

要使用 UI 生成路由报告，请执行以下步骤:

  1. 从浏览器打开 IBM Cloud 控制台并登录账户。

  2. 选择左上角的菜单图标 Menu 图标，然后单击 Infrastructure（基础架构 ）> Network（网络 ）> Direct Link ）。

  3. 在 Direct Link 表中，单击要为其生成报告的 Direct Link 名称。

  4. 在“详细信息”页面上，单击 BGP 选项卡，然后向下滚动到 路由 选项卡式视图。 然后，单击 生成报告 链接。

    或者，您可以使用“概述”选项卡上的 路由报告 快捷方式。

    路由报告开始构建，可能需要几分钟才能生成，具体取决于直接链路的复杂性。 请记住，在完成报告处理之前，或者除非单击 取消报告，否则无法生成其他报告。

生成报告后，将在检修路线报告表中显示以下列。

  • Route-指定路由地址 (例如，169.254.0.40/29)。

  • Type-指定路由类型:

    • 连接-指定路由源自的特定连接的名称 (或标识)。
    • 网关 - 在要建立 BGP 的 IBM 路由器上设置。
    • On prem - 源自内部数据中心。

    您可以展开 On-prem 行以查看 AS 路径，下一个中继段和任何冲突。 对于“连接”类型，展开行以显示 AS 路径，本地 pref，源和任何冲突。

  • 已广告-指定是已广告，已学习还是未广告。

    仅当建立 BGP 时，才会公布路由。

  • 冲突-指定是否存在路由冲突。

选择“设置”图标 "设置" 图标 以更改表的行高或编辑列设置。

路由冲突

冲突路由显示在“路由”视图的 冲突 列中。 配置直接链路时，重叠路由是一个常见问题。 如果来自两个或多个连接的路由重叠，那么可能无法正确路由流量。 例如：

显示路由报告
显示路由报告

如果存在多个冲突，请单击链接以打开包含更多信息的侧面板。 解决冲突后，生成新报告。

使用 CLI 生成和查看路由报告

要使用 CLI 生成和查看路由报告，请运行以下命令:

ibmcloud dl route-report-create|rrc GATEWAY_ID [--output format] [--help|-h]

其中：

  • GATEWAY_ID 是网关的 ID。
  • -- output json 以 JSON 格式格式化输出。
    • -help | -h 获取该命令的帮助。

例如，要为直接链路创建检修路线报告，请执行以下操作:

ibmcloud dl route-report-create a771366f-2c8c-49f6-a23b-9d49fad035a3

有关更多信息，请参阅 ibmcloud dl route-report 命令。

使用 API 生成和查看路由报告

要使用 API 生成和查看路由报告，请执行以下步骤:

  1. 使用正确的变量设置 API 环境。

  2. 存储要在 API 命令中使用的任何其他变量，例如:

    direct_link_id="11111111-b540-4766-a196-14368f328eb2"

  3. 请求报告创建:

    curl -X POST "$directlink_api_endpoint/v1/gateways/$direct_link_id/route_reports?version=$api_version" -H "Authorization: $iam_token"

    对于其他调用，您需要知道新创建报告的 ID。 将该标识保存在变量中，例如：

    route_report="22222222-c540-4766-a196-14368f328eb2"

    要验证变量是否已保存，请运行 echo $route_report 并确保响应不为空。

  4. 等待报告变为活动状态，然后可以查看其详细信息:

    curl -X GET "$directlink_api_endpointv1/gateways/$direct_link_id/route_reports/$route_report?version=$api_version" -H "Authorization: $iam_token"

    有关更多信息，请参阅 网关路由报告 API。