IBM Cloud Docs
Direct Link CLI

Direct Link CLI

IBM Cloud® Direct Link 命令行界面（CLI）分为多个部分，在导航窗口中一一列出。

准备工作

完成以下步骤即可使用 Direct Link CLI，它是作为 IBM Cloud CLI 插件实现的。 该插件为您提供了通过 CLI 界面管理服务实例及其相关资源的方法。

  1. 安装 IBM Cloud CLI。

  2. 将 dl-cli 插件安装到 IBM Cloud CLI。

    要安装插件，请输入以下命令。

    ibmcloud plugin install dl-cli

ibmcloud plugin show dl-cli

显示 Direct Link CLI 插件信息。

ibmcloud plugin show dl-cli

ibmcloud dl --help

获取有关 Direct Link 命令的帮助。

ibmcloud dl -h|--help

ibmcloud dl asprepends

列出指定网关上的所有 AS 前缀。

ibmcloud dl asprepends GATEWAY_ID

命令选项

GATEWAY_ID
指定网关的 ID。 必需。

示例

  • ibmcloud dl asprepends 5cc19d0a-792c-4595-adfc-f90fc650de01
  • ibmcloud dl asps 22f799e8-b4ab-44ca-856b-897be9b0e53d

ibmcloud dl asprepends-replace

替换指定网关上的所有 AS 前缀。

ibmcloud dl asprepends-replace GATEWAY_ID --file JSON_FILE --etag ETAG

命令选项

GATEWAY_ID
指定网关的 ID。 必需。
-file JSON_FILE
输入数据的 JSON 文件。 该文件包含要应用到网关的 AS 前缀。
--etag ETAG
当前定义的 AS 的 Etag 值。 该值将在 ibmcloud dl asprepends 和应用更新后的命令响应中返回。

示例

  • ibmcloud dl asprepends-replace 5cc19d0a-792c-4595-adfc-f90fc650de01 --file update.json --etag 'W/\"20-3e8f21374fef9e548af910e4ad4322abe25bfb41\"'
  • ibmcloud dl aspsr 22f799e8-b4ab-44ca-856b-897be9b0e53d --file update.json --etag 'W/\"20-3e8f21374fef9e5477770e4ad4322abe25bfb41\"'

ibmcloud dl completion-notice

在当前工作目录或输出目录路径下下载网关的完成通知。

ibmcloud dl completion-notice|cn GATEWAY_ID [--file OUTPUT_DIRECTORY_PATH][--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。 必需。
--file OUTPUT_DIRECTORY_PATH
指定要下载完成通知的输出目录路径。 例如，指定在 /tmp 目录中下载完成通知。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl completion-notice 0e28b9bc-06df-44f1-b5d7-08085b9fc935
  • ibmcloud dl cn 0e28b9bc-06df-44f1-b5d7-08085b9fc935 --file /tmp

ibmcloud dl completion-notice-update

从工作目录或指定目录上传完成通知。

ibmcloud dl completion-notice-update GATEWAY_ID [-i INPUT_DIRECTORY_PATH]

命令选项

GATEWAY_ID
指定网关的 ID。 必需。
-i INPUT_DIRECTORY_PATH
指定要上传完成通知的目录。

示例

  • ibmcloud dl completion-notice-update 5cc19d0a-792c-4595-adfc-f90fc650de01
  • ibmcloud dl cnu 22f799e8-b4ab-44ca-856b-897be9b0e53d -i /tmp/

ibmcloud dl connect-gateway-create

创建连接网关。

BGP_BASE_CIDR 选项已被弃用。 删除该选项，因为它会被忽略。 请参阅 BGP_CER_CIDR 和 BGP_IBM_CIDR，使用自动或显式 IP 分配创建网关。

ibmcloud dl connect-gateway-create {--file JSON_FILE | GATEWAY_NAME --billing BILLING --bgp-asn BGP_ASN --port-id PORT_ID --routing ROUTING --speed-mbps SPEED_MBPS [--bfd-interval interval] [--bfd-multiplier multiplier] [--bgp-base-cidr BGP_BASE_CIDR] [--bgp-cer-cidr BGP_CER_CIDR] [--bgp-ibm-cidr BGP_IBM_CIDR] [--connection CONNECTION_TYPE] [--resource-group-id RESOURCE_GROUP_ID]} [--help|-h] [--output format]

命令选项

--file JSON_FILE
输入数据的 JSON 文件。 AS Prepend 和 Route Filter 值的输入方法。 必填或指定 GATEWAY_NAME。
GATEWAY_NAME
指定新网关的名称。 必填或指定 --file JSON_FILE。
--billing BILLING
资源计费 (metered | non-metered)。选择 metered 按 GB 计费，选择 non-metered 按统一费率计费。 必需。
--bgp-asn BGP_ASN
指定默认值 64999，或从允许的范围中选择一个 ASN。 必需。
--port-id PORT_ID
网关的端口标识。 类型为 connect 时为必填项。 必需。
--routing ROUTING
资源的网关路由（全局 | 本地）。 选择全局可跨区域连接资源。 必需。
--speed-mbps SPEED_MBPS
指定速度值。 必需。
--bfd-interval VALUE
配置传输和接收 BFD 数据包之间的最小间隔（毫秒）。 范围 [300 - 255000]
--bfd-multiplier VALUE
邻居未收到的 BFD 数据包数量，该数据包会导致源接口被宣布停机。 范围 [1 - 255]
--bgp-base-cidr BGP_BASE_CIDR
指定 BGP 基本 CIDR。
--bgp-cer-cidr BGP_CER_CIDR
指定 BGP 客户边缘路由器 CIDR。
--bgp-ibm-cidr BGP_IBM_CIDR
指定 BGP IBM CIDR。
--connection CONNECTION_TYPE:
要绑定到直接连接的网络连接类型。 之一：direct, transit。
--default-export-route-filter VALUE
缺省导出路由过滤器。 permit, deny 之一。
--default-import-route-filter VALUE
缺省导入路径过滤器。 permit, deny 之一。
--resource-group-id RESOURCE_GROUP_ID
此资源的资源组标识。 如果未指定，则使用账户的默认资源组。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

要 为 BGP 对等体启用 MD5 身份验证，或创建 BGP AS 前缀，请使用 --file 按照 模板 中所述创建网关的选项。

示例

  • ibmcloud dl connect-gateway-create dl-gw --billing metered --bgp-asn 64999 --bgp-base-cidr 169.254.0.51/30 --port-id 2f41cf65-e72a-4522-9526-e156e4ca02b5 --routing local --speed-mbps 1000 --bgp-cer-cidr 169.254.0.53/30 --bgp-ibm-cidr 169.254.0.52/30 --connection direct
  • ibmcloud dl connect-gateway-create dl-gw --billing metered --bgp-asn 64999 --bgp-base-cidr 169.254.0.51/30 --port-id 2f41cf65-e72a-4522-9526-e156e4ca02b5 --routing local --speed-mbps 1000 --bgp-cer-cidr 169.254.0.53/30 --bgp-ibm-cidr 169.254.0.52/30 --output json
  • ibmcloud dl connect-gateway-create --file ~/gateway.json

ibmcloud dl dedicated-gateway-create

创建专用网关。

BGP_BASE_CIDR 选项已被弃用。 删除该选项，因为它会被忽略。 请参阅 BGP_CER_CIDR 和 BGP_IBM_CIDR，使用自动或显式 IP 分配创建网关。

ibmcloud dl dedicated-gateway-create {--file JSON_FILE | GATEWAY_NAME --billing BILLING --bgp-asn BGP_ASN --carrier-name CARRIER_NAME --ccr CROSS_CONNECT_ROUTER --customer-name CUSTOMER_NAME --location-name LOCATION_NAME --routing ROUTING --speed-mbps SPEED_MBPS [--bfd-interval interval] [--bfd-multiplier multiplier] [--bgp-base-cidr BGP_BASE_CIDR] [--bgp-cer-cidr BGP_CER_CIDR] [--bgp-ibm-cidr BGP_IBM_CIDR] [-vlan VLAN] [--connection CONNECTION_TYPE] [--resource-group-id RESOURCE_GROUP_ID]} [--output format]

命令选项

GATEWAY_NAME
指定新网关的名称。
--file VALUE
输入数据的 JSON 文件。 AS Prepend 和 Route Filter 值的输入方法。
--bfd-interval VALUE
配置传输和接收 BFD 数据包之间的最小间隔（毫秒）。 范围 [300 - 255000]
--bfd-multiplier VALUE
邻居未收到的 BFD 数据包数量，该数据包会导致源接口被宣布停机。 范围 [1 - 255]
--bgp-asn VALUE
指定默认值 64999，或从允许的范围中选择一个 ASN。
--bgp-base-cidr BGP_BASE_CIDR
指定 BGP 基本 CIDR。
--bgp-cer-cidr BGP_CER_CIDR
指定 BGP 客户边缘路由器 CIDR。
--bgp-ibm-cidr BGP_IBM_CIDR
指定 BGP IBM CIDR。
--billing VALUE
资源计费 (metered | non-metered)。选择 metered 按 GB 计费，选择 non-metered 按统一费率计费。
--carrier-name VALUE
指定网关 CARRIER NAME。
--connection VALUE
要绑定到直接连接的网络连接类型。 之一：direct, transit。
--ccr XCR
为 Direct Link 连接选择 IBM 交叉连接路由器。
--customer-name VALUE
指定网关 CUSTOMER NAME。
--default-export-route-filter VALUE
缺省导出路由过滤器。 permit, deny 之一。
--default-import-route-filter VALUE
缺省导入路径过滤器。 permit, deny 之一。
--location-name LOCATION
指定位置名称，例如 dal10。
--resource-group-id VALUE
此资源的资源组标识。 如果未指定，则使用账户的默认资源组。
--routing VALUE
资源的网关路由 (global | local)。选择 global 可跨区域连接资源。
--speed-mbps SPEED_MBPS
指定速度值。
--vlan VLAN
指定 VLAN 编号。 范围 [2-3967]。使用 null 重置。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

要创建启用 MACsec 的网关、为 BGP 对等体启用 MD5 身份验证 或创建 BGP AS 前置，请使用 --file 按照 模板 中所述创建网关的选项。

示例

  • ibmcloud dl dedicated-gateway-create dl-gw --billing metered --bgp-asn 64999 --bgp-base-cidr 169.254.0.51/30 --carrier-name carrier --ccr LAB-xcr01.dal09 --customer-name customer --location-name dal09 --routing local --speed-mbps 1000 --bgp-ibm-cidr 169.254.0.52/30 --bgp-cer-cidr 169.254.0.53/30 --vlan 10 --connection direct
  • ibmcloud dl dedicated-gateway-create dl-gw --billing metered --bgp-asn 64999 --bgp-base-cidr 169.254.0.51/30 --carrier-name carrier --ccr LAB-xcr01.dal09 --customer-name customer --location-name dal09 --routing local --speed-mbps 1000 --bgp-ibm-cidr 169.254.0.52/30 --bgp-cer-cidr 169.254.0.53/30 --output json
  • ibmcloud dl dedicated-gateway-create --file ~/gateway.json

ibmcloud dl export-route-filter

按 ID 查看导出路由过滤器的详细信息。

ibmcloud dl export-route-filter|erf GATEWAY_ID FILTER_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
FILTER_ID
指定要列出的导出路由过滤器的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl erf beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6

ibmcloud dl export-route-filters

列出所有导出路由筛选器。

ibmcloud dl export-route-filters|erfs GATEWAY_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

ibmcloud dl erfs beec5de0-a1c0-4730-8888-2ce4a3020ec8

ibmcloud dl export-route-filter-create

创建导出路由过滤器。

ibmcloud dl export-route-filter-create|erfc GATEWAY_ID --action ACTION --prefix PREFIX [--before BEFORE] [--ge GE] [--le LE] [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--action ACTION
指定导出路由过滤器的操作。 permit, deny 之一。
--prefix PREFIX
指定 IPv4 子网 CIDR，同时指明地址和掩码长度。
--before BEFORE
要在导出路由过滤器列表中确定此过滤器的优先级，请指定排在此过滤器之前的路由过滤器的 ID。
--ge GE
指定最小匹配长度（GE，大于或等于）。 更多信息，请参阅 关于路由过滤。
--le LE
指定最大匹配长度（LE，小于或等于）。 更多信息，请参阅 关于路由过滤。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl erfc dc206f57-5693-442f-8888-6d43b6c82d73 --action permit --prefix 10.10.0.0/24
  • ibmcloud dl erfc dc206f57-5693-442f-8888-6d43b6c82d73 --action deny --prefix 10.10.0.0/24 -le 29

ibmcloud dl export-route-filter-delete

删除导出路由过滤器。

ibmcloud dl export-route-filter-delete|erfd GATEWAY_ID FILTER_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
FILTER_ID
指定要删除的导出路由过滤器的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl erfd beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6

ibmcloud dl export-route-filter-replace

替换所有导出路由过滤器。

ibmcloud dl export-route-filter-replace|erfr GATEWAY_ID --file JSON_FILE --etag ETAG [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--file JSON_FILE
指定输入数据的 JSON 文件。
--etag ETAG
指定 eTag。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

ibmcloud dl erfr 58e4f46f-0dab-4025-9999-3df974db0618 --etag 'W/"182-9c1ba4f4ab697f4080f662c18e664d5763ae4b8dcb0542b4b473d661"' --file ~/export.txt

ibmcloud dl export-route-filter-update

更新导出路由过滤器。

ibmcloud dl export-route-filter-update|erfu GATEWAY_ID [--action ACTION] [--prefix PREFIX] [--before BEFORE] [--ge GE] [--le LE] [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--action ACTION
指定导出路由过滤器的操作。 permit, deny 之一。
--prefix PREFIX
指定 IPv4 子网 CIDR，同时指明地址和掩码长度。
--before BEFORE
要在导出路由过滤器列表中确定此过滤器的优先级，请指定排在此过滤器之前的路由过滤器的 ID。
--ge GE
指定最小匹配长度（GE，大于或等于）。 更多信息，请参阅 关于路由过滤。
--le LE
指定最大匹配长度（LE，小于或等于）。 更多信息，请参阅 关于路由过滤。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl erfu beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6 --action permit
  • ibmcloud dl erfu beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6 --le 28

ibmcloud dl gateway

查看特定网关的详细信息。

ibmcloud dl gateway|gw GATEWAY_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl gateway a771366f-2c8c-49f6-a23b-9d49fad035a3
  • ibmcloud dl gw a771366f-2c8c-49f6-a23b-9d49fad035a3 --output json

ibmcloud dl gateway-change-approve

批准网关变更申请。

ibmcloud dl gateway-change-approve GATEWAY_ID {--file JSON_FILE | [--action Action] [--bfd-interval interval] [--bfd-multiplier multiplier] [--bgp-asn BGP_ASN] [--bgp-cer-cidr BGP_CER_CIDR] [--bgp-ibm-cidr BGP_IBM_CIDR] [--billing BILLING] [--connection CONNECTION_TYPE] [--resource-group-id RESOURCE_GROUP_ID] [--routing ROUTING] [--speed-mbps SPEED_MBPS] [--vlan VLAN]} [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--file VALUE
输入数据的 JSON 文件。 AS 预置值的输入方法。
--action ACTION
操作请求。 之一：gateway-create, gateway-delete, gateway-attribute-update。
--bfd-interval VALUE
配置传输和接收 BFD 数据包之间的最小间隔（毫秒）。 范围 [300 - 255000]
--bfd-multiplier VALUE
邻居未收到的 BFD 数据包数量，该数据包会导致源接口被宣布停机。 范围 [1 - 255]
--bgp-asn VALUE
网关 BGP-ASN。 排除的 ASN：0、13884、36351、64512、64513、65100、65201‍-‍65234、65402‍-‍65433、65500 和 4201065000‍-‍4201065999
--bgp-cer-cidr VALUE
BGP 客户边缘路由器 CIDR
--bgp-ibm-cidr VALUE
BGP IBM CIDR
--billing VALUE
计费 (metered | non-metered)。选择 metered 按 GB 计费，选择 non-metered 按统一费率计费。 针对 gateway-create 请求进行设置以选择网关的计量计费选项。
-connection VALUE
要绑定到直接连接的网络连接类型。 之一：direct, transit。
--resource-group-id VALUE
此资源的资源组标识。 针对 gateway-create 请求进行设置以选择网关的资源组。
--routing ROUTING
网关路由 (global | local)。选择 global 可跨区域连接资源。 为网关创建请求设置，以选择网关路由选项。
--speed-mbps SPEED_MBPS
网关的速度（Mbps）。
--vlan VALUE
网关 vlan 标识
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

要批准提供商创建的网关，并 为 BGP 对等方提供 MD5 身份验证，或创建 BGP AS 前缀，请使用 -file 选项批准 模板 中所述的网关。

示例

  • ibmcloud dl gateway-change-approve a771366f-2c8c-49f6-a23b-9d49fad035a3 --action gateway-create --routing global --billing metered
  • ibmcloud dl gateway-change-approve a771366f-2c8c-49f6-a23b-9d49fad035a3 --action gateway-create --routing global --billing metered --connection direct --output json

ibmcloud dl gateway-change-reject

拒绝网关更改请求。

ibmcloud dl gateway-change-reject|gwcr GATEWAY_ID [--action Action] [--bgp-asn BGP_ASN] [--bgp-cer-cidr BGP_CER_CIDR] [--bgp-ibm-cidr BGP_IBM_CID] [--speed-mbps SPEED_MBPS] [--vlan VLAN] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--action ACTION
操作请求。 之一：gateway-create, gateway-delete, gateway-attribute-update。
--bgp-asn VALUE
网关 BGP-ASN。 排除的 ASN：0、13884、36351、64512、64513、65100、65201‍-‍65234、65402‍-‍65433、65500 和 4201065000‍-‍4201065999
--bgp-cer-cidr VALUE
BGP 客户边缘路由器 CIDR
--bgp-ibm-cidr VALUE
BGP IBM CIDR
--speed-mbps SPEED_MBPS
网关的速度（Mbps）。
--vlan VLAN
网关 vlan 标识
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl gateway-change-reject a771366f-2c8c-49f6-a23b-9d49fad035a3 --action gateway-create
  • ibmcloud dl gateway-change-reject a771366f-2c8c-49f6-a23b-9d49fad035a3 --action gateway-create --output json

ibmcloud dl gateway-create

创建网关。

不推荐使用该命令。 请参阅 connect-gateway-create 和 dedicated-gateway-create 来创建 Connect 和 Dedicated 网关。

BGP_BASE_CIDR 选项已被弃用。 删除该选项，因为它会被忽略。 请参阅 BGP_CER_CIDR 和 BGP_IBM_CIDR，使用自动或显式 IP 分配创建网关。

ibmcloud dl gateway-create|gwc GATEWAY_NAME --billing BILLING --bgp-asn BGP_ASN  --bgp-base-cidr BGP_BASE_CIDR --routing ROUTING --speed-mbps SPEED_MBPS --type TYPE [--bgp-cer-cidr BGP_CER_CIDR] [--bgp-ibm-cidr BGP_IBM_CIDR] [--carrier-name CARRIER_NAME] [--cross-connect-router CROSS_CONNECT_ROUTER] [--customer-name CUSTOMER_NAME] [--location-name LOCATION_NAME] [--port-id PORT_ID] [--resource-group-id RESOURCE_GROUP_ID] [-–help|-h] [--output format]

命令选项

GATEWAY_NAME
指定新网关的名称。
--billing VALUE
资源计费（计量 | 非计量）。 选择计量收费按千兆字节收费，选择非计量收费按统一费率收费。
--bgp-asn VALUE
指定默认值 64999，或从允许的范围中选择一个 ASN。
--bgp-base-cidr BGP_BASE_CIDR
指定 BGP 基本 CIDR。
--bgp-cer-cidr BGP_CER_CIDR
指定 BGP 客户边缘路由器 CIDR。
--bgp-ibm-cidr BGP_IBM_CIDR
指定 BGP IBM CIDR。
--carrier-name VALUE
指定网关运营商名称。
--cross-connect-router XCR
为 Direct Link 连接选择 IBM 交叉连接路由器。
--customer-name VALUE
指定网关客户名称。
--location-name LOCATION
指定位置名称，例如 dal10。
--port-id
网关的端口标识。 类型为 connect 时为必填项。
--resource-group-id VALUE
此资源的资源组标识。 如果未指定，则使用账户的默认资源组。
--routing VALUE
资源的网关路由 (global | local)。选择“全球”可跨区域连接资源。
--speed-mbps SPEED_MBPS
指定速度值。
--type TYPE
指定 Direct Link 产品类型。 之一：dedicated, connect。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl gateway-create dl-gw --bgp-asn 64999 --cross-connect-router LAB-xcr01.dal09 --routing local --billing metered --location-name dal09 --speed-mbps 1000 --type dedicated --bgp-base-cidr 169.254.0.51/30 --bgp-ibm-cidr 169.254.0.52/30 --bgp-cer-cidr 169.254.0.53/30
  • ibmcloud dl gateway-create dl-gw --bgp-asn 64999 --cross-connect-router LAB-xcr01.dal09 --routing local --billing metered --location-name dal09 --speed-mbps 1000 --type dedicated --bgp-base-cidr 169.254.0.51/30 --bgp-ibm-cidr 169.254.0.52/30 --bgp-cer-cidr 169.254.0.53/30 --output json

ibmcloud dl gateway-delete

删除特定网关。

ibmcloud dl gateway-delete|gwd GATEWAY_ID [--help|-h] [--force|-f]

命令选项

GATEWAY_ID
指定网关的 ID。
--help|-h
获取有关此命令的帮助。
--force|-f
强制删除操作，无需确认。

示例

  • ibmcloud dl gateway-delete e281b18b-0dba-49ee-9c64-aea588b7f1fd
  • ibmcloud dl gateway-delete 8ba9e7b0-dded-400e-ad7e-6481dad0b157 -f

ibmcloud dl gateway-statistics

获取特定网关的统计数据。

ibmcloud dl gateway-statistics|gw-stats GATEWAY_ID --type STATISTIC_TYPE [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
type VALUE
要检索的统计数据类型。 之一：macsec_mka_session, macsec_policy, macsec_mka_statistics, bfd_session。
--help|-h
获取有关此命令的帮助。

示例

ibmcloud dl gateway-statistics e281b18b-0dba-49ee-9c64-aea588b7f1fd --type macsec_mka_session

ibmcloud dl gateway-status

读取网关状态

ibmcloud dl gateway-status GATEWAY_ID --type STATUS_TYPE [--output format] [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
--type VALUE
指定要检索的状态。 bgp|bfd|link 之一。
--output VALUE
指定输出格式。 仅支持 JSON。
--help|-h
获取有关此命令的帮助。

示例

ibmcloud dl gateway-statistics e281b18b-0dba-49ee-9c64-aea588b7f1fd --type macsec_mka_session

ibmcloud dl gateway-update

更新特定网关。

ibmcloud dl gateway-update GATEWAY_ID {--file JSON_FILE | [--bfd-interval interval] [--bfd-multiplier multiplier] [--bgp-asn BGP_ASN] [--bgp-cer-cidr BGP_CER_CIDR] [--bgp-ibm-cidr BGP_IBM_CIDR] [--billing BILLING] [--connection CONNECTION_TYPE]  [--default-export-route-filter DEFAULT_ACTION] [--default-import-route-filter DEFAULT_ACTION] [--loa-reject-reason LOA_REJECT_REASON] [--name NAME] [--operational-status OPERATION_STATUS] [--routing ROUTING] [--speed-mbps SPEED_MBPS]} [--vlan VLAN] [--clear-vlan VALUE] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--file VALUE
输入数据的 JSON 文件。
--bfd-interval VALUE
配置传输和接收 BFD 数据包之间的最小间隔（毫秒）。 范围 [300 - 255000]
--bfd-multiplier VALUE
邻居未收到的 BFD 数据包数量，该数据包会导致源接口被宣布停机。 范围 [1 - 255]
--bgp-asn VALUE
网关 BGP-ASN。 排除的 ASN：0、13884、36351、64512、64513、65100、65201‍-‍65234、65402‍-‍65433、65500 和 4201065000‍-‍4201065999
--bgp-cer-cidr VALUE
BGP 客户边缘路由器 CIDR。
--bgp-ibm-cidr VALUE
BGP IBM CIDR。
--billing VALUE
资源计费 (metered | non-metered)。选择 metered 按 GB 计费，选择 non-metered 按统一费率计费。
--connection VALUE
要绑定到直接连接的网络连接类型。 之一：direct, transit。
--default-export-route-filter VALUE
缺省导出路由过滤器。 其中之一：permit, deny。
--default-import-route-filter VALUE
缺省导入路径过滤器。 其中之一：permit, deny。
--loa-reject-reason LOA_REJECT_REASON
说明拒绝授权书（LOA）的原因。
--name NAME
网关名称。
--operational-status OPERATIONAL_STATUS
指定网关的运行状态。 数值为 loa_accepted 或 loa_rejected。
--routing VALUE
资源的网关路由 (global | local)。选择 global 可跨区域连接资源。
--speed-mbps SPEED_MBPS
以 Mbps 为单位指定网关的速度。
--vlan VALUE
指定 VLAN 编号。 范围 [2-3967]。使用 null 重置。 网关的 type 必须为 dedicated。 可选。
--clear-vlan
清除专用网关中的映射 VLAN。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

要清除/更新 BGP 对等体的 MD5 身份验证，请使用 --file 选项更新 模板 中所述的网关。

示例

  • ibmcloud dl gateway-update 8ba9e7b0-dded-400e-ad7e-6481dad0b157 --speed-mbps 5000 --vlan 99 --name dl-gw-updated
  • ibmcloud dl gateway-update 8ba9e7b0-dded-400e-ad7e-6481dad0b157 --speed-mbps 5000 --vlan null --name dl-gw-updated --output json
  • ibmcloud dl gateway-update 8ba9e7b0-dded-400e-ad7e-6481dad0b157 --connection transit --output json
  • ibmcloud dl gateway-update 8ba9e7b0-dded-400e-ad7e-6481dad0b157 --file ~/gateway-update.json

ibmcloud dl gateways

列出所有网关。

ibmcloud dl gateways|gws [-–help|-h] [--output format]

命令选项

--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

ibmcloud dl import-route-filter

按 ID 查看导入路由过滤器的详细信息。

ibmcloud dl import-route-filter|irf GATEWAY_ID FILTER_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
FILTER_ID
指定要列出的导入路由过滤器的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

ibmcloud dl irf beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6

ibmcloud dl import-route-filters

列出所有导入路由筛选器。

ibmcloud dl import-route-filters|irfs GATEWAY_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

ibmcloud dl irfs beec5de0-a1c0-4730-8888-2ce4a3020ec8

ibmcloud dl import-route-filter-create

创建导入路由过滤器。

ibmcloud dl import-route-filter-create|irfc GATEWAY_ID --action ACTION --prefix PREFIX [--before BEFORE] [--ge GE] [--le LE] [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--action ACTION
指定导入路由过滤器的操作。 permit, deny 之一。
--prefix PREFIX
指定 IPv4 子网 CIDR，同时指明地址和掩码长度。
--before BEFORE
要在导入路由过滤器列表中确定此过滤器的优先级，请指定排在此过滤器之前的路由过滤器的 ID。
--ge GE
指定最小匹配长度（GE，大于或等于）。 更多信息，请参阅 关于路由过滤。
--le LE
指定最大匹配长度（LE，小于或等于）。 更多信息，请参阅 关于路由过滤。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl irfc dc206f57-5693-442f-8888-6d43b6c82d73 --action permit --prefix 10.10.0.0/24
  • ibmcloud dl irfc dc206f57-5693-442f-8888-6d43b6c82d73 --action deny --prefix 10.10.0.0/24 -le 29

ibmcloud dl import-route-filter-delete

导入导出路由过滤器。

ibmcloud dl import-route-filter-delete|irfd GATEWAY_ID FILTER_ID [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
FILTER_ID
指定要删除的导入路由筛选器的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

ibmcloud dl irfd beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6

ibmcloud dl import-route-filter-replace

替换所有导入路由过滤器。

ibmcloud dl import-route-filter-replace|irfr GATEWAY_ID --file JSON_FILE --etag ETAG [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--file JSON_FILE
指定输入数据的 JSON 文件。
--etag ETAG
指定 eTag。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

ibmcloud dl irfr 58e4f46f-0dab-4025-9999-3df974db0618 --etag 'W/"182-9c1ba4f4ab697f4080f662c18e664d5763ae4b8dcb0542b4b473d661"' --file ~/import.txt

ibmcloud dl import-route-filter-update

更新导入路由过滤器。

ibmcloud dl import-route-filter-update|irfu GATEWAY_ID [--action ACTION] [--prefix PREFIX] [--before BEFORE] [--ge GE] [--le LE] [-–help|-h] [--output format]

命令选项

GATEWAY_ID
指定网关的 ID。
--action ACTION
指定导入路由过滤器的操作。 permit, deny 之一。
--prefix PREFIX
指定 IPv4 子网 CIDR，同时指明地址和掩码长度。
--before BEFORE
要在导入路由过滤器列表中确定此过滤器的优先级，请指定排在此过滤器之前的路由过滤器的 ID。
--ge GE
指定最小匹配长度（GE，大于或等于）。 更多信息，请参阅 关于路由过滤。
--le LE
指定最大匹配长度（LE，小于或等于）。 更多信息，请参阅 关于路由过滤。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl irfu beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6 --action permit
  • ibmcloud dl irfu beec5de0-a1c0-4730-8888-2ce4a3020ec8 c3df351b-ff64-4444-ba64-92cb7622dfd6 --le 28

ibmcloud dl loa

下载当前工作目录或指定目录中网关的 LOA。

ibmcloud dl loa GATEWAY_ID [--file OUTPUT_DIRECTORY_PATH] [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
--file OUTPUT_DIRECTORY_PATH
指定输出目录路径。 例如，指定在 /tmp 目录中下载 LOA。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl loa 5cc19d0a-792c-4595-adfc-f90fc650de01
  • ibmcloud dl loa 5cc19d0a-792c-4595-adfc-f90fc650de01 --file /tmp

ibmcloud dl location

检索特定产品类型的特定位置信息。

ibmcloud dl location|loc LOCATION_NAME OFFERING_TYPE [--help|-h] [--output format]

命令选项

LOCATION_NAME
指定位置名称。
OFFERING_TYPE
指定 Direct Link 产品类型。 目前只支持 dedicated。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl location "Washington 2" dedicated
  • ibmcloud dl loc "Washington 2" dedicated --output json

ibmcloud dl locations

列出特定 Direct Link 产品类型的位置。

ibmcloud dl locations|locs OFFERING_TYPE [–-output format] [--help|-h]

命令选项

OFFERING_TYPE
指定 Direct Link 产品类型。 数值为 dedicated 或 connect。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl locations dedicated
  • ibmcloud dl locs dedicated --output json

ibmcloud dl offering-speeds

列出某产品类型的所有发售速度。

ibmcloud dl offering-speeds|ospeeds OFFERING_TYPE [--output format] [--help|-h]

命令选项

OFFERING_TYPE
指定 Direct Link 产品类型。 数值为 dedicated 或 dedicated_hosting。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl offering-speeds dedicated
  • ibmcloud dl ospeeds dedicated_hosting --output json

ibmcloud dl port

查看端口的详细信息。

ibmcloud dl port PORT_ID [--help|-h] [--output format]

命令选项

PORT_ID
指定端口的 ID。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl port a771366f-2c8c-49f6-a23b-9d49fad035a3
  • ibmcloud dl port a771366f-2c8c-49f6-a23b-9d49fad035a3 --output json

ibmcloud dl ports

列出所有端口。

ibmcloud dl ports [--help|-h] [--output format]

命令选项

--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl ports
  • ibmcloud dl ports --output json

ibmcloud dl route-report

查看路线报告的详细信息。

ibmcloud dl route-report|rr GATEWAY_ID REPORT_ID [--output format] [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
REPORT_ID
指定路由报告 ID 的 ID。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl route-report a771366f-2c8c-49f6-a23b-9d49fad035a3 dea35ba0-7323-4d8d-9c8d-d7ecda55e23d
  • ibmcloud dl rr a771366f-2c8c-49f6-a23b-9d49fad035a3 dea35ba0-7323-4d8d-9c8d-d7ecda55e23d --output json

ibmcloud dl route-report-create

创建路线报告。

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

命令选项

GATEWAY_ID
指定网关的 ID。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl route-report-create a771366f-2c8c-49f6-a23b-9d49fad035a3
  • ibmcloud dl rrc a771366f-2c8c-49f6-a23b-9d49fad035a3 --output json

ibmcloud dl route-report-delete

删除路由报告。

ibmcloud dl route-report-delete|rrd GATEWAY_ID REPORT_ID [--output format] [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
REPORT_ID
指定路由报告 ID 的 ID。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl route-report-delete a771366f-2c8c-49f6-a23b-9d49fad035a3 dea35ba0-7323-4d8d-9c8d-d7ecda55e23d
  • ibmcloud dl rrd a771366f-2c8c-49f6-a23b-9d49fad035a3 dea35ba0-7323-4d8d-9c8d-d7ecda55e23d --output json

ibmcloud dl route-reports

列出所有路线报告。

ibmcloud dl route-reports|rrs GATEWAY_ID [--output format] [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl route-reports a771366f-2c8c-49f6-a23b-9d49fad035a3
  • ibmcloud dl rrs a771366f-2c8c-49f6-a23b-9d49fad035a3 --output json

ibmcloud dl virtual-connection

查看虚拟连接的详细信息。

ibmcloud dl virtual-connection|vc GATEWAY_ID VIRTUAL_CONNECTION_ID [--output format] [--help|-h]

命令选项

GATEWAY_ID
指定网关的 ID。
VIRTUAL_CONNECTION_ID
指定虚拟连接的 ID。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl virtual-connection a771366f-2c8c-49f6-a23b-9d49fad035a3 dea35ba0-7323-4d8d-9c8d-d7ecda55e23d
  • ibmcloud dl vc a771366f-2c8c-49f6-a23b-9d49fad035a3 dea35ba0-7323-4d8d-9c8d-d7ecda55e23d --output json

ibmcloud dl virtual-connection-create

创建虚拟连接。

ibmcloud dl virtual-connection-create|vcc --type TYPE --network-id NETWORK_ID --name VIRTUAL_CONNECTION_NAME [--help|-h] [--output format]

命令选项

--type TYPE
指定虚拟连接类型。 数值为 classic 或 vpc。
--network-id NETWORK_ID
指定网络 ID。 使用 classic 类型时不需要。
--name NAME
指定虚拟连接的名称。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。
--help|-h
获取有关此命令的帮助。

示例

  • ibmcloud dl virtual-connection-create fb0df64a-ef8d-4b3c-b473-dc0230593529 --type vpc --network-id crn:v1:staging:public:is:us-south:a/28e4d90ac7504be694471ee66e70d0d5::vpc:r134-b8b62f60-f152-471f-971a-376da52721e0 --name newVC
  • ibmcloud dl vcc fb0df64a-ef8d-4b3c-b473-dc0230593529 --type vpc --network-id crn:v1:staging:public:is:us-south:a/28e4d90ac7504be694471ee66e70d0d5::vpc:r134-b8b62f60-f152-471f-971a-376da52721e0 --name newVC --output json

ibmcloud dl virtual-connection-delete

删除虚拟连接。

ibmcloud dl virtual-connection-delete|vcd GATEWAY_ID VIRTUAL_CONNECTION_ID [--help|-h] [--force|-f]

命令选项

GATEWAY_ID
指定网关的 ID。
VIRTUAL_CONNECTION_ID
指定虚拟连接的 ID。
--help|-h
获取有关此命令的帮助。
--force|-f
强制删除操作，无需确认。

示例

  • ibmcloud dl virtual-connection-delete fb0df64a-ef8d-4b3c-b473-dc0230593529 0b1e165c-a89c-4682-9771-dbe062e3acf7
  • ibmcloud dl vcd fb0df64a-ef8d-4b3c-b473-dc0230593529 26284b6e-78a9-416c-ba5e-2b6ec085f18b -f

ibmcloud dl virtual-connection-update

更新虚拟连接。

ibmcloud dl virtual-connection-update|vcu [--name NAME] [--status STATUS] [--help|-h] [--output format]

命令选项

--name NAME
指定虚拟连接的名称。
--status STATUS
指定虚拟连接状态。 数值为 attached 或 rejected。
--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl virtual-connection-update fb0df64a-ef8d-4b3c-b473-dc0230593529 3d577350-9450-4fd0-94b6-2f6da21b828e --name newVCUpdated
  • ibmcloud dl vcu adaa0879-3509-4e71-b02b-0c7587ccbcfa 9b11fa61-6e74-4a8f-b978-bca1bead097f --name newVCUpdated --output json

ibmcloud dl virtual-connections

列出虚拟连接。

ibmcloud dl virtual-connections|vcs [--help|-h] [--output format]

命令选项

--help|-h
获取有关此命令的帮助。
--output VALUE
指定是否要以 JSON 格式显示输出。 目前，json 是唯一支持的格式。

示例

  • ibmcloud dl virtual-connections a771366f-2c8c-49f6-a23b-9d49fad035a3
  • ibmcloud dl vcs a771366f-2c8c-49f6-a23b-9d49fad035a3 --output json