快速入门：使用 Azure CLI 创建和修改 ExpressRoute 线路

项目
07/17/2023

本快速入门介绍如何使用命令行接口 (CLI) 创建 Azure ExpressRoute 线路。本文还介绍如何检查状态，以及如何更新、删除和取消预配线路。

Diagram of ExpressRoute circuit deployment environment using Azure CLI.

先决条件

在开始配置之前，请查看先决条件和工作流。
具有活动订阅的 Azure 帐户。创建试用版订阅。
安装最新版本的 CLI 命令（2.0 或更高版本）。有关安装 CLI 命令的信息，请参阅安装 Azure CLI 和 Azure CLI 入门。

注意

在可以在由世纪互联运营的 Microsoft Azure 中使用 Azure CLI 之前，请先运行 az cloud set -n AzureChinaCloud 来更改云环境。若要切换回 Azure 公有云，请再次运行 az cloud set -n AzureCloud。

创建和预配 ExpressRoute 线路

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

az login

检查该帐户的订阅。

az account list

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

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

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

在创建 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 线路。

创建 ExpressRoute 线路

重要

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

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

az group create -n ExpressRouteResourceGroup -l "chinanorth"

以下示例演示如何通过位于北京的 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 "chinanorth" --sku-family MeteredData --sku-tier Standard

响应将包含服务密钥。

列出所有 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

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

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

创建新的 ExpressRoute 线路时，线路将为以下状态：

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

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

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

若要使用 ExpressRoute 线路，该线路必须处于以下状态：

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

定期检查线路密钥的状态

通过检查服务密钥的状态，可了解提供商何时预配了线路。配置线路后，ServiceProviderProvisioningState 会显示为已预配，如以下例所示：

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]

创建路由配置

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

重要

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

将虚拟网络链接到 ExpressRoute 线路

接下来，将虚拟网络链接到 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 个。否则，更新请求会失败，并且我们将按高级版费率向你收费。
必须首先取消其他地理政治区域的所有虚拟网络的链接。如果不删除链接，更新请求会失败，并且我们会继续按高级版费率向你收费。
路由表中专用对等互连的路由必须少于 4,000。如果你的路由表大小大于 4,000 路由，BGP 会话则会掉线。在播发的前缀数量低于 4,000 之前，不会重新建立 BGP 会话。

可以使用以下示例为现有线路禁用 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

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

将 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

后续步骤

创建线路并将其预配到提供商后，继续执行下一步，以配置对等互连：

创建和修改 ExpressRoute 线路的路由