Criar e modificar um circuito do ExpressRoute usando a CLICreate and modify an ExpressRoute circuit using CLI

Este artigo descreve como criar um circuito do Azure ExpressRoute usando a CLI (Interface de Linha de Comando).This article describes how to create an Azure ExpressRoute circuit by using the Command Line Interface (CLI). Este artigo também mostra como verificar o status, atualizar ou excluir e desprovisionar um circuito.This article also shows you how to check the status, update, or delete and deprovision a circuit. Se quiser usar um método diferente para trabalhar com circuitos do ExpressRoute, você poderá selecionar um artigo na lista a seguir:If you want to use a different method to work with ExpressRoute circuits, you can select the article from the following list:

Antes de começarBefore you begin

Criar e provisionar um circuito do ExpressRouteCreate and provision an ExpressRoute circuit

1. Faça login na sua conta do Azure e selecione sua assinatura1. Sign in to your Azure account and select your subscription

Para iniciar sua configuração, entrar na sua conta do Azure.To begin your configuration, sign in to your Azure account. Se usar o "Experimente" do CloudShell, você é conectado automaticamente.If you use the CloudShell "Try It", you are signed in automatically. Use o exemplo a seguir para ajudar a conectar:Use the following examples to help you connect:

az login

Verificar as assinaturas da conta.Check the subscriptions for the account.

az account list

Selecione a assinatura para a qual você deseja criar um circuito do ExpressRoute.Select the subscription for which you want to create an ExpressRoute circuit.

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

2. Obtenha a lista de provedores, locais e larguras de banda suportados2. Get the list of supported providers, locations, and bandwidths

Antes de criar um circuito de ExpressRoute você precisará de uma lista de provedores de conectividade com suporte, dos locais e de opções de largura de banda.Before you create an ExpressRoute circuit, you need the list of supported connectivity providers, locations, and bandwidth options. O comando az network express-route list-service-providers CLI retorna essas informações, que você usará em etapas posteriores:The CLI command az network express-route list-service-providers returns this information, which you’ll use in later steps:

az network express-route list-service-providers

A resposta é semelhante ao seguinte exemplo:The response is similar to the following example:

[
  {
    "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": "AARNet",
    "peeringLocations": [
      "Melbourne",
      "Sydney"
    ],
    "provisioningState": "Succeeded",
    "resourceGroup": "",
    "tags": null,
    "type": "Microsoft.Network/expressRouteServiceProviders"
  },

Verifique a resposta para ver se o provedor de conectividade está listado.Check the response to see if your connectivity provider is listed. Anote as informações a seguir, pois você precisará delas quando criar um circuito:Make a note of the following information, which you will need when you create a circuit:

  • NomeName
  • PeeringLocationsPeeringLocations
  • BandwidthsOfferedBandwidthsOffered

Agora você está pronto para criar um circuito do ExpressRoute.You're now ready to create an ExpressRoute circuit.

3. Crie um circuito ExpressRoute3. Create an ExpressRoute circuit

Importante

O circuito do ExpressRoute será cobrado a partir do momento em que uma chave de serviço for emitida.Your ExpressRoute circuit is billed from the moment a service key is issued. Execute esta operação quando o provedor de conectividade estiver pronto para provisionar o circuito.Perform this operation when the connectivity provider is ready to provision the circuit.

Se você ainda não tiver um grupo de recursos, deverá criar um antes de criar o circuito do ExpressRoute.If you don't already have a resource group, you must create one before you create your ExpressRoute circuit. Você pode criar um grupo de recursos executando o seguinte comando:You can create a resource group by running the following command:

az group create -n ExpressRouteResourceGroup -l "West US"

O exemplo a seguir mostra como criar um circuito do ExpressRoute de 200 Mbps por meio da Equinix, no Vale do Silício.The following example shows how to create a 200-Mbps ExpressRoute circuit through Equinix in Silicon Valley. Se estiver usando um provedor diferente e configurações diferentes, substitua essas informações ao fazer a solicitação.If you're using a different provider and different settings, substitute that information when you make your request.

Especifique a camada da SKU e a família de SKUs corretas:Make sure that you specify the correct SKU tier and SKU family:

  • O nível SKU determina se um circuito ExpressRoute é Local,Padrão ou Premium.SKU tier determines whether an ExpressRoute circuit is Local, Standard or Premium. Você pode especificar Local, Standard ou Premium.You can specify Local, Standard or Premium.
  • A família da SKU determina o tipo de cobrança.SKU family determines the billing type. Você pode especificar dados medidos para um plano de dados medido e dados ilimitados para um plano de dados ilimitado.You can specify Metereddata for a metered data plan and Unlimiteddata for an unlimited data plan. É possível alterar o tipo de cobrança de Metereddata para Unlimiteddata, mas não é possível alterar o tipo de Unlimiteddata para Metereddata.You can change the billing type from Metereddata to Unlimiteddata, but you can't change the type from Unlimiteddata to Metereddata. Um circuito local é apenas ilimitado.A Local circuit is Unlimiteddata only.

O circuito do ExpressRoute será cobrado a partir do momento em que uma chave de serviço for emitida.Your ExpressRoute circuit is billed from the moment a service key is issued. O exemplo a seguir é uma solicitação de uma nova chave de serviço:The following example is a request for a new service key:

az network express-route create --bandwidth 200 -n MyCircuit --peering-location "Silicon Valley" -g ExpressRouteResourceGroup --provider "Equinix" -l "West US" --sku-family MeteredData --sku-tier Standard

A resposta conterá a chave de serviço.The response contains the service key.

4. Liste todos os circuitos ExpressRoute4. List all ExpressRoute circuits

Para obter uma lista de todos os circuitos ExpressRoute que você criou, execute o az network express-route list comando.To get a list of all the ExpressRoute circuits that you created, run the az network express-route list command. Você pode recuperar essas informações a qualquer momento usando este comando.You can retrieve this information at any time by using this command. Para listar todos os circuitos, faça a chamada sem parâmetros.To list all circuits, make the call with no parameters.

az network express-route list

Sua chave de serviço está listada no campo ServiceKey da resposta.Your service key is listed in the ServiceKey field of the response.

"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": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

Você pode obter descrições detalhadas de todos os parâmetros executando comando com o parâmetro '-h'.You can get detailed descriptions of all the parameters by running the command using the '-h' parameter.

az network express-route list -h

5. Envie a chave de serviço ao seu provedor de conectividade para provisionamento5. Send the service key to your connectivity provider for provisioning

'ServiceProviderProvisioningState' fornece informações sobre o estado atual de provisionamento no lado do provedor de serviço.'ServiceProviderProvisioningState' provides information about the current state of provisioning on the service-provider side. O status fornece o estado no lado da Microsoft.The status provides the state on the Microsoft side. Para obter mais informações, consulte o artigo Fluxos de trabalho.For more information, see the Workflows article.

Quando você cria um novo circuito do ExpressRoute, ele está no seguinte estado:When you create a new ExpressRoute circuit, the circuit is in the following state:

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

O circuito assumirá o seguinte o estado quando o provedor de conectividade estiver habilitando-o para você:The circuit changes to the following state when the connectivity provider is in the process of enabling it for you:

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

Para que você consiga usar um circuito do ExpressRoute, ele deverá estar no seguinte estado:For you to be able to use an ExpressRoute circuit, it must be in the following state:

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

6. Verifique periodicamente o estado e o estado da chave do circuito6. Periodically check the status and the state of the circuit key

A verificação do status e o estado da chave do circuito informará quando o provedor tiver habilitado seu circuito.Checking the status and the state of the circuit key lets you know when your provider has enabled your circuit. Após a configuração do circuito, o 'ServiceProviderProvisioningState' será exibido como 'Provisioned', conforme mostrado neste exemplo:After the circuit has been configured, 'ServiceProviderProvisioningState' appears as 'Provisioned', as shown in the following example:

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

A resposta é semelhante ao seguinte exemplo:The response is similar to the following example:

"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": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

7. Crie sua configuração de roteamento7. Create your routing configuration

Para obter instruções passo a passo, confira o artigo configuração do roteamento de circuito do ExpressRoute para criar e modificar os emparelhamentos de circuito.For step-by-step instructions, see the ExpressRoute circuit routing configuration article to create and modify circuit peerings.

Importante

Estas instruções aplicam-se apenas a circuitos criados com provedores de serviço que oferecem serviços de conectividade de camada 2.These instructions only apply to circuits that are created with service providers that offer layer 2 connectivity services. Se você estiver usando um provedor de serviços que oferece serviços gerenciados de camada 3 (normalmente um IP VPN, como MPLS), seu provedor de conectividade configurará e gerenciará o roteamento para você.If you're using a service provider that offers managed layer 3 services (typically an IP VPN, like MPLS), your connectivity provider configures and manages routing for you.

Em seguida, vincule uma rede virtual a seu circuito do ExpressRoute.Next, link a virtual network to your ExpressRoute circuit. Use o artigo Vincular redes virtuais aos circuitos do ExpressRoute.Use the Linking virtual networks to ExpressRoute circuits article.

Modificar um circuito do ExpressRouteModifying an ExpressRoute circuit

Você pode modificar certas propriedades de um circuito do ExpressRoute sem afetar a conectividade.You can modify certain properties of an ExpressRoute circuit without impacting connectivity. Você pode fazer as seguintes alterações sem tempo de inatividade:You can make the following changes with no downtime:

  • Você pode habilitar ou desabilitar o complemento ExpressRoute Premium para seu circuito do ExpressRoute.You can enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • Você pode aumentar a largura de banda do circuito de ExpressRoute, desde que haja capacidade disponível na porta.You can increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. Não há suporte para o downgrade da largura de banda de um circuito.However, downgrading the bandwidth of a circuit is not supported.
  • Altere o plano de medição de Dados Limitados para Dados Ilimitados.You can change the metering plan from Metered Data to Unlimited Data. No entanto, não há suporte para alteração do plano de medição de Dados Ilimitados para Dados Limitados.However, changing the metering plan from Unlimited Data to Metered Data is not supported.
  • Você pode habilitar e desabilitar Permitir Operações Clássicas.You can enable and disable Allow Classic Operations.

Para saber mais sobre limites e limitações, confira as Perguntas frequentes sobre o ExpressRoute.For more information on limits and limitations, see the ExpressRoute FAQ.

Para habilitar o complemento premium do ExpressRouteTo enable the ExpressRoute premium add-on

Você pode habilitar o complemento ExpressRoute Premium para o circuito existente usando o seguinte comando:You can enable the ExpressRoute premium add-on for your existing circuit by using the following command:

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

Agora, o circuito terá os recursos do complemento ExpressRoute Premium habilitados.The circuit now has the ExpressRoute premium add-on features enabled. Começaremos a cobrar pela funcionalidade do complemento Premium assim que o comando for executado com êxito.We begin billing you for the premium add-on capability as soon as the command has successfully run.

Para desabilitar o complemento premium do ExpressRouteTo disable the ExpressRoute premium add-on

Importante

Esta operação poderá falhar se você estiver usando recursos que ultrapassem o que é permitido para o circuito padrão.This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

Antes de desabilitar o complemento ExpressRoute Premium, entenda os seguintes critérios:Before disabling the ExpressRoute premium add-on, understand the following criteria:

  • Antes de fazer o downgrade de Premium para Standard, verifique se o número de redes virtuais vinculadas ao circuito é menor do que 10.Before you downgrade from premium to standard, you must make sure that you have fewer than 10 virtual networks linked to the circuit. Se existirem mais de 10, sua solicitação de atualização falhará e você será cobrado de acordo com as tarifas Premium.If you have more than 10, your update request fails, and we bill you at premium rates.
  • Você precisa desvincular todas as redes virtuais em outras regiões geopolíticas.You must unlink all virtual networks in other geopolitical regions. Se você não desvincular todas as redes virtuais, sua solicitação de atualização falhará e cobraremos de acordo com as tarifas premium.If you don't unlink all your virtual networks, your update request fails and we bill you at premium rates.
  • Sua tabela de roteamento deve ter menos de 4.000 rotas para o emparelhamento privado.Your route table must be less than 4,000 routes for private peering. Se o tamanho da tabela de rotas for maior que 4.000 rotas, a sessão de BGP será suspensa.If your route table size is greater than 4,000 routes, the BGP session drops. A sessão não será habilitada novamente até que o número de prefixos anunciados esteja abaixo de 4.000.The session won't be reenabled until the number of advertised prefixes is below 4,000.

Você pode desabilitar o complemento ExpressRoute Premium para o circuito existente usando o seguinte exemplo:You can disable the ExpressRoute premium add-on for the existing circuit by using the following example:

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

Para atualizar a largura de banda do circuito do ExpressRouteTo update the ExpressRoute circuit bandwidth

Para obter as opções de largura de banda com suporte para seu provedor, confira as Perguntas frequentes sobre o ExpressRoute.For the supported bandwidth options for your provider, check the ExpressRoute FAQ. Você pode escolher qualquer tamanho maior do que o tamanho do circuito existente.You can pick any size greater than the size of your existing circuit.

Importante

Talvez seja necessário recriar o circuito do ExpressRoute se não houver capacidade adequada na porta existente.If there is inadequate capacity on the existing port, you may have to recreate the ExpressRoute circuit. Você não pode atualizar o circuito não se houver capacidade adicional disponível nesse local.You cannot upgrade the circuit if there is no additional capacity available at that location.

Não é possível reduzir a largura de banda de um circuito do ExpressRoute sem interrupções.You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. O downgrade da largura de banda exige o desprovisionamento do circuito do ExpressRoute e um reprovisionamento de um novo circuito do ExpressRoute.Downgrading bandwidth requires you to deprovision the ExpressRoute circuit, and then reprovision a new ExpressRoute circuit.

Depois de decidir qual tamanho você precisa, use o seguinte comando para redimensionar o circuito:After you decide the size you need, use the following command to resize your circuit:

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

O circuito é dimensionado no lado da Microsoft.Your circuit is sized up on the Microsoft side. Em seguida, contate seu provedor de conectividade para que faça a atualização das configurações no lado dele de modo a corresponder a essa alteração.Next, you must contact your connectivity provider to update configurations on their side to match this change. Depois que você fizer essa notificação, começaremos a cobrar pela opção de largura de banda atualizada.After you make this notification, we begin billing you for the updated bandwidth option.

Para mover a SKU de limitado para ilimitadoTo move the SKU from metered to unlimited

Você pode alterar a SKU de um circuito do ExpressRoute usando o seguinte exemplo:You can change the SKU of an ExpressRoute circuit by using the following example:

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

Para controlar o acesso aos ambientes clássico e do Resource ManagerTo control access to the classic and Resource Manager environments

Confira as instruções em Mover os circuitos de ExpressRoute do modelo de implantação Clássico para o Resource Manager.Review the instructions in Move ExpressRoute circuits from the classic to the Resource Manager deployment model.

Desprovisionamento e exclusão de um circuito do ExpressRouteDeprovisioning and deleting an ExpressRoute circuit

Para desprovisionar e excluir um circuito do ExpressRoute, você precisa entender os seguintes critérios:To deprovision and delete an ExpressRoute circuit, make sure you understand the following criteria:

  • Você deve desvincular todas as redes virtuais do circuito do ExpressRoute.You must unlink all virtual networks from the ExpressRoute circuit. Se essa operação falhar, verifique se há redes virtuais vinculadas ao circuito.If this operation fails, check to see if any virtual networks are linked to the circuit.
  • Se o estado de provisionamento do provedor de serviços de circuito ExpressRoute estiver provisionando ou provisionando, você deve trabalhar com seu provedor de serviços para desprovisionar o circuito ao seu lado.If the ExpressRoute circuit service provider provisioning state is Provisioning or Provisioned, you must work with your service provider to deprovision the circuit on their side. Continuaremos a reservar recursos e a cobrar de você até que o provedor de serviços complete o desprovisionamento do circuito e nos notifique.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • Você poderá excluir o circuito se ele tiver sido desprovisionado pelo provedor de serviços.You can delete the circuit if the service provider has deprovisioned the circuit. Quando um circuito é desprovisionado, o estado de provisionamento do provedor de serviço é definido como Não provisionado.When a circuit is deprovisioned, the service provider provisioning state is set to Not provisioned. Isso interrompe a cobrança pelo circuito.This stops billing for the circuit.

Você pode excluir o circuito do ExpressRoute executando o comando a seguir:You can delete your ExpressRoute circuit by running the following command:

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

Próximas etapasNext steps

Depois de criar o circuito, não deixe de realizar as seguintes tarefas:After you create your circuit, make sure that you do the following tasks: