使用 CLI 创建和修改 ExpressRoute 线路

本文介绍如何使用命令行接口 (CLI) 创建 Azure ExpressRoute 线路。 本文还介绍如何检查状态,以及如何更新、删除和取消预配线路。 如果想使用不同的方法处理 ExpressRoute 线路,请从以下列表中选择一篇文章进行参阅:

准备阶段

创建和预配 ExpressRoute 线路

1.登录到 Azure 帐户,并选择订阅

要开始配置,请登录到 Azure 帐户。 使用下面的示例来帮助你连接:

az login

检查该帐户的订阅。

az account list

选择要为其创建 ExpressRoute 线路的订阅。

az account set --subscription "<subscription ID>"

2.获取支持的提供商、位置和带宽的列表

在创建 ExpressRoute 线路之前,需要支持的连接服务提供商、位置和带宽选项的列表。 CLI 命令“az network express-route list-service-providers”会返回此信息,在随后的步骤中会使用此信息:

az network express-route list-service-providers

其响应类似于如下示例:

[
  {
    "bandwidthsOffered": [
      {
        "offerName": "50Mbps",
        "valueInMbps": 50
      },
      {
        "offerName": "100Mbps",
        "valueInMbps": 100
      },
      {
        "offerName": "200Mbps",
        "valueInMbps": 200
      },
      {
        "offerName": "500Mbps",
        "valueInMbps": 500
      },
      {
        "offerName": "1Gbps",
        "valueInMbps": 1000
      },
      {
        "offerName": "2Gbps",
        "valueInMbps": 2000
      },
      {
        "offerName": "5Gbps",
        "valueInMbps": 5000
      },
      {
        "offerName": "10Gbps",
        "valueInMbps": 10000
      }
    ],
    "id": "/subscriptions//resourceGroups//providers/Microsoft.Network/expressRouteServiceProviders/",
    "location": null,
    "name": "Beijing Telecom Ethernet",
    "peeringLocations": [
      "Beijing"
    ],
    "provisioningState": "Succeeded",
    "resourceGroup": "",
    "tags": null,
    "type": "Microsoft.Network/expressRouteServiceProviders"
  },

查看此响应以检查自己的连接服务提供商是否已在此处列出。 请记下以下信息,稍后在创建线路时需要用到:

  • 名称
  • PeeringLocations
  • BandwidthsOffered

现在,已经准备创建 ExpressRoute 线路。

3.创建 ExpressRoute 线路

重要

从发布服务密钥的那一刻起,会对 ExpressRoute 线路进行计费。 在连接服务提供商准备好预配线路后,请执行此操作。

如果尚未有资源组,则在创建 ExpressRoute 线路之前,必须先创建一个资源组。 可以运行以下命令来创建资源组:

az group create -n ExpressRouteResourceGroup -l "China North"

以下示例演示如何通过位于北京的 Beijing Telecom Ethernet 创建 200-Mbps 的 ExpressRoute 线路。 如果使用其他提供商和其他设置,请在发出请求时替换该信息。

请确保指定合适的 SKU 层和 SKU 系列:

  • SKU 层确定 ExpressRoute 线路是本地线路、标准线路还是高级线路。 可以指定“本地”、“标准” 或“高级”**。
  • SKU 系列确定计费类型。 可以指定“Metereddata”** 以获取数据流量套餐,指定“Unlimiteddata”** 以获取无限制流量套餐。 可以将计费类型从“Metereddata”** 更改为“Unlimiteddata”,但不能将类型从“Unlimiteddata” 更改为“Metereddata”。 “本地” 线路仅为 Unlimiteddata**。

从发布服务密钥的那一刻起,将对 ExpressRoute 线路进行计费。 以下是请求新的服务密钥的示例:

az network express-route create --bandwidth 200 -n MyCircuit --peering-location "Beijing" -g ExpressRouteResourceGroup --provider "Beijing Telecom Ethernet" -l "China North" --sku-family MeteredData --sku-tier Standard

响应将包含服务密钥。

4.列出所有 ExpressRoute 线路

要获取已创建的所有 ExpressRoute 线路的列表,请运行 az network express-route list 命令。 可以随时使用此命令检索此信息。 若要列出所有线路,请进行不带任何参数的调用。

az network express-route list

服务密钥会在响应的 ServiceKey 字段中列出**。

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "chinanorth",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Beijing",
  "serviceProviderName": "Beijing Telecom Ethernet"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

可以通过使用“-h”参数运行以下命令获取所有参数的详细说明。

az network express-route list -h

5.将服务密钥发送给连接服务提供商进行预配

“ServiceProviderProvisioningState”提供有关服务提供商端当前预配状态的信息。 此状态提供 Microsoft 端的状态。 有关详细信息,请参阅工作流文章

创建新的 ExpressRoute 线路时,线路将为以下状态:

"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"

当连接服务提供商正在为你启用线路时,线路将更改为以下状态:

"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"

只有 ExpressRoute 线路处于以下状态时,才能使用它。

"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled

6.定期检查线路密钥的状态

检查线路密钥的状态,可以通过此状态了解提供商何时启用了线路。 配置线路后,“ServiceProviderProvisioningState” 会显示为“Provisioned”,如以下示例所示:

az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit

其响应类似于如下示例:

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "chinanorth",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Beijing",
  "serviceProviderName": "Beijing Telecom Ethernet"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

7.创建路由配置

有关分步说明,请参阅 ExpressRoute 线路路由配置一文,了解如何创建和修改线路对等互连。

重要

这些说明仅适用于由提供第 2 层连接服务的服务提供商创建的线路。 如果服务提供商提供第 3 层托管服务(通常是 IP VPN,如 MPLS),则连接服务提供商会配置和管理路由。

接下来,将虚拟网络链接到 ExpressRoute 线路。 按照将虚拟网络链接到 ExpressRoute 线路文章中的内容进行操作。

修改 ExpressRoute 线路

可以在不影响连接的情况下修改 ExpressRoute 线路的某些属性。 可以在不停机的情况下进行以下更改:

  • 为 ExpressRoute 线路启用或禁用 ExpressRoute 高级版外接程序。
  • 增加 ExpressRoute 线路的带宽,前提是端口上有可用容量。 但不支持对线路的带宽进行降级。
  • 将计量套餐从数据流量套餐更改为无限制流量套餐。 但不支持将计量套餐从无限制流量套餐更改为数据流量套餐。
  • 可以启用和禁用允许经典操作**。

有关限制和局限性的详细信息,请参阅 ExpressRoute 常见问题解答

启用 ExpressRoute 高级版外接程序

可以使用以下命令为现有线路启用 ExpressRoute 高级版外接程序:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium

线路现已启用 ExpressRoute 高级版外接程序功能。 该命令成功运行后,我们就会开始对高级版外接程序功能进行计费。

禁用 ExpressRoute 高级版外接程序

重要

如果使用的资源超出了标准线路允许的范围,此操作可能会失败。

在禁用 ExpressRoute 高级版外接程序之前,请了解以下条件:

  • 从高级版降级到标准版之前,必须确保链接到线路的虚拟网络数量少于 10。 如果超过 10 个,更新请求则会失败,并且我们将按高级版费率进行收费。
  • 必须取消其他地理政治区域的所有虚拟网络的链接。 如果没有对所有虚拟网络取消链接,更新请求则会失败,并且我们将按高级版费率进行收费。
  • 路由表中专用对等互连的路由必须少于 4,000。 如果你的路由表大小大于 4,000 路由,BGP 会话则会掉线。 在播发的前缀数量小于 4,000 之前,不会重新启用此会话。

可以使用以下示例为现有线路禁用 ExpressRoute 高级版外接程序:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard

更新 ExpressRoute 线路带宽

有关提供商支持的带宽选项,请查看 ExpressRoute 常见问题解答。 可以选取大于现有线路大小的任何大小。

重要

如果现有端口上的容量不足,则可能需要重新创建 ExpressRoute 线路。 如果该位置没有额外的可用容量,则不能升级线路。

但是,无法在不中断的情况下降低 ExpressRoute 线路的带宽。 带宽降级要求取消对 ExpressRoute 线路的预配,并重新预配新的 ExpressRoute 线路。

确定所需的大小后,可以使用以下命令调整线路的大小:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000

线路的大小会在 Microsoft 端进行调整。 接着,必须联系你的连接服务提供商,让他们在那一端根据此更改更新配置。 在发出此通知后,我们将开始对更新后的带宽选项进行计费。

将 SKU 从按流量计费转为不受限制

可以通过使用以下示例更改 ExpressRoute 线路的 SKU:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData

控制对经典环境和 Resource Manager 环境的访问

查看将 ExpressRoute 线路从经典部署模型转移到 Resource Manager 部署模型中的说明。

取消设置和删除 ExpressRoute 线路

若要取消预配并删除 ExpressRoute 线路,请确保已了解以下条件:

  • 必须取消所有虚拟网络与 ExpressRoute 线路的链接。 如果此操作失败,请查看是否有虚拟网络链接到了该线路。
  • 如果 ExpressRoute 线路服务提供商预配状态为“正在预配”或“已预配”,则必须与服务提供商合作,在他们那一端取消预配线路 。 在服务提供商完成取消设置线路并通知我们之前,我们会继续保留资源并向你收费。
  • 如果服务提供商已取消预配线路,则可以删除此线路。 取消预配线路后,服务提供商预配状态将被设置为“未预配”****。 这样就会停止对线路的计费。

可以通过运行以下命令来删除 ExpressRoute 线路:

az network express-route delete  -n MyCircuit -g ExpressRouteResourceGroup

后续步骤

创建线路后,请务必执行以下任务: