生成直接链路路由报告
您可以生成直接链路及其连接已知的所有路径的报告。 此报告允许您验证期望的路由,查看哪些虚拟连接正在向直接链路提供哪些路由,以及查看接收到的路由的下一个中继段地址详细信息。 如果使用跨帐户 VPC 链接功能,您还可以查看正在通过交叉连接路由器路由哪些前缀或子网。
您可以使用 UI,CLI 或 API 来检索路由报告。
路线报告注意事项
使用检修路线报告时,请查看以下注意事项:
- 在新的虚拟连接 (VPC,经典或 Transit Gateway) 达到
Active
状态后,请允许 5 分钟通过直接链路了解路径。 在学习所有路由之前生成路由报告将生成部分路由报告。 - 在 BGP 设置为
Established
状态后,大约 5 分钟后,本地路由才会显示。 直到网关完成供应之后,网关路由才会显示。 - 如果连接公开
0.0.0.0/0
的路由,那么在计算重叠前缀时将忽略该路由。 - 每个网关在任何时候只有一个报告可用。 如果生成新报告,那么将删除旧报告。
- 添加或除去连接后,较旧的路由报告可能不准确。 因此,如果在这些连接中更新路由,那么建议您生成新的路由报告。
使用 UI 生成路由报告
要使用 UI 生成路由报告,请执行以下步骤:
-
从浏览器打开 IBM Cloud 控制台并登录账户。
-
选择左上角的菜单图标
,然后单击 Infrastructure(基础架构 )> Network(网络 )> Direct Link )。
-
在 Direct Link 表中,单击要为其生成报告的 Direct Link 名称。
-
在“详细信息”页面上,单击 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 生成和查看路由报告,请执行以下步骤:
-
使用正确的变量设置 API 环境。
-
存储要在 API 命令中使用的任何其他变量,例如:
direct_link_id="11111111-b540-4766-a196-14368f328eb2"
-
请求报告创建:
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
并确保响应不为空。 -
等待报告变为活动状态,然后可以查看其详细信息:
curl -X GET "$directlink_api_endpointv1/gateways/$direct_link_id/route_reports/$route_report?version=$api_version" -H "Authorization: $iam_token"
有关更多信息,请参阅 网关路由报告 API。