Início Rápido: Criar e modificar um circuito do ExpressRoute usando a CLI do Azure
Este início rápido descreve como criar um circuito do Azure ExpressRoute usando a CLI (interface de linha de comando). Este artigo também mostra como verificar o status, atualizar ou excluir e desprovisionar um circuito.
Pré-requisitos
- Examine os pré-requisitos e os fluxos de trabalho antes de começar a configuração.
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Instale a versão mais recente dos comandos da CLI (2.0 ou posterior). Para saber mais sobre como instalar os comandos da CLI, confira Instalar a CLI do Azure e Introdução à CLI do Azure.
Azure Cloud Shell
O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção | Exemplo/Link |
|---|---|
| Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell. |  |
| Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. |  |
| Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure. |  |
Para usar o Azure Cloud Shell:
Inicie o Cloud Shell.
Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou o comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.
Pressione Enter para executar o código ou comando.
Criar e provisionar um circuito do ExpressRoute
Entre na sua conta do Azure e selecione sua assinatura
Para iniciar sua configuração, entrar na sua conta do Azure. Se usar a funcionalidade Experimente do Cloud Shell, você entrará automaticamente. Use o exemplo a seguir para ajudar a conectar:
az login
Verificar as assinaturas da conta.
az account list
Selecione a assinatura para a qual você deseja criar um circuito do ExpressRoute.
az account set --subscription "<subscription ID>"
Obtenha a lista de provedores, de locais e de larguras de banda com suporte
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. O comando da CLI az network express-route list-service-providers retorna as seguintes informações, que você usa em etapas posteriores:
az network express-route list-service-providers
A resposta é semelhante ao seguinte exemplo:
[
{
"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. Anote as seguintes informações, pois você precisa delas para criar um circuito:
- Nome
- PeeringLocations
- BandwidthsOffered
Agora você está pronto para criar um circuito do ExpressRoute.
Criar um circuito do ExpressRoute
Importante
O circuito do ExpressRoute será cobrado a partir do momento em que uma chave de serviço for emitida. Execute esta operação quando o provedor de conectividade estiver pronto para provisionar o circuito.
Se você ainda não tiver um grupo de recursos, deverá criar um antes de criar o circuito do ExpressRoute. Você pode criar um grupo de recursos executando o seguinte comando:
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. Se estiver usando um provedor diferente e configurações diferentes, substitua essas informações ao fazer a solicitação.
Especifique a camada da SKU e a família de SKUs corretas:
- O nível de SKU determina se o circuito do ExpressRoute será Local, Standard ou Premium. Você poderá especificar Local, *Standard ou Premium.
- A família do SKU determina o tipo de cobrança. Você pode especificar MeteredData para um plano de dados limitados e UnlimitedData para um plano de dados ilimitados. É possível alterar o tipo de cobrança de MeteredData para UnlimitedData, mas não de UnlimitedData para MeteredData. Um circuito Local é somente UnlimitedData.
O circuito do ExpressRoute será cobrado a partir do momento em que uma chave de serviço for emitida. O exemplo a seguir é uma solicitação de uma nova chave de serviço:
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.
Listar todos os circuitos do ExpressRoute
Para obter uma lista com todos os circuitos do ExpressRoute criados, execute o comando az network express-route list. Você pode recuperar essas informações a qualquer momento usando este comando. Para listar todos os circuitos, faça a chamada sem parâmetros.
az network express-route list
Sua chave de serviço está listada no campo ServiceKey da resposta.
"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'.
az network express-route list -h
Enviar a chave de serviço ao seu provedor de conectividade para obter provisionamento
'ServiceProviderProvisioningState' fornece informações sobre o estado atual de provisionamento no lado do provedor de serviço. O status fornece o estado no lado da Microsoft. Para obter mais informações, consulte o artigo Fluxos de trabalho.
Quando você cria um novo circuito do ExpressRoute, ele está no seguinte estado:
"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"
O circuito assumirá o seguinte estado quando o provedor de conectividade estiver habilitando ele para você:
"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"
Para usar o circuito do ExpressRoute, ele precisa estar no seguinte estado:
"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled
Verifique periodicamente o status e o estado da chave do circuito
A verificação do status e do estado da chave do serviço informará você quando o provedor tiver provisionado o circuito. Após a configuração do circuito, o ServiceProviderProvisioningState será exibido como Provisioned, como mostrado neste exemplo:
az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit
A resposta é semelhante ao seguinte exemplo:
"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]
Criar sua configuração de roteamento
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.
Importante
Estas instruções aplicam-se apenas a circuitos criados com provedores de serviço que oferecem serviços de conectividade de camada 2. 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ê.
Vincular uma rede virtual a um circuito de ExpressRoute
Em seguida, vincule uma rede virtual a seu circuito do ExpressRoute. Use o artigo Vincular redes virtuais aos circuitos do ExpressRoute.
Modificando um circuito do ExpressRoute
Você pode modificar certas propriedades de um circuito do ExpressRoute sem afetar a conectividade. Você pode fazer as seguintes alterações sem tempo de inatividade:
- Você pode habilitar ou desabilitar o complemento ExpressRoute Premium para seu circuito do ExpressRoute.
- Você pode aumentar a largura de banda do circuito do ExpressRoute, contanto que haja capacidade disponível na porta. No entanto, não há suporte para fazer downgrade da largura de banda de um circuito.
- Altere o plano de medição de Dados Limitados para Dados Ilimitados. No entanto, não há suporte para alterar o plano de medição de Dados Ilimitados para Dados Limitados.
- Você pode habilitar e desabilitar Permitir Operações Clássicas.
Para saber mais sobre limites e limitações, confira as Perguntas frequentes sobre o ExpressRoute.
Para habilitar o complemento premium do ExpressRoute
Você pode habilitar o complemento ExpressRoute Premium para o circuito existente usando o seguinte comando:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium
Agora, o circuito terá os recursos do complemento ExpressRoute Premium habilitados. Começaremos a cobrar pela funcionalidade do complemento Premium assim que o comando for executado com êxito.
Para desabilitar o complemento premium do ExpressRoute
Importante
Esta operação poderá falhar se você estiver usando recursos que ultrapassem o que é permitido para o circuito padrão.
Antes de desabilitar o complemento ExpressRoute Premium, entenda os seguintes critérios:
- Antes de fazer o downgrade de premium para standard, verifique se o número de redes virtuais vinculadas ao circuito é menor que 10. Se você não fizer isso, sua solicitação de atualização falhará e você será cobrado conforme as tarifas premium.
- Todas as redes virtuais em outras regiões geopolíticas primeiro devem ser desvinculadas. Se você não remove o vínculo, a solicitação de atualização falha e seguimos cobrando as tarifas premium.
- Sua tabela de roteamento deve ter menos de 4.000 rotas para o emparelhamento privado. Se o tamanho da tabela de rotas for maior que 4.000 rotas, a sessão de BGP será suspensa. A sessão do BGP não é reestabelecida até que o número de prefixos anunciados seja inferior a 4.000.
Você pode desabilitar o complemento ExpressRoute Premium para o circuito existente usando o seguinte exemplo:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard
Para atualizar a largura de banda do circuito do ExpressRoute
Para obter as opções de largura de banda com suporte para seu provedor, confira as Perguntas frequentes sobre o ExpressRoute. Você pode escolher qualquer tamanho maior do que o tamanho do circuito existente.
Importante
Talvez seja necessário recriar o circuito do ExpressRoute se não houver capacidade adequada na porta existente. Você não pode atualizar o circuito não se houver capacidade adicional disponível nesse local.
Não é possível reduzir a largura de banda de um circuito do ExpressRoute sem interrupções. O downgrade da largura de banda exige o desprovisionamento do circuito do ExpressRoute e um reprovisionamento de um novo circuito do ExpressRoute.
Depois de decidir qual tamanho você precisa, use o seguinte comando para redimensionar o circuito:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000
O circuito é atualizado no lado da Microsoft. 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. Depois que você fizer essa notificação, começaremos a cobrar pela opção de largura de banda atualizada.
Para mover a SKU de limitado para ilimitado
Você pode alterar a SKU de um circuito do ExpressRoute usando o seguinte exemplo:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData
Para controlar o acesso aos ambientes clássico e do Resource Manager
Confira as instruções em Mover os circuitos de ExpressRoute do modelo de implantação Clássico para o Resource Manager.
Como desprovisionar um circuito do ExpressRoute
Para desprovisionar e excluir um circuito do ExpressRoute, você precisa entender os seguintes critérios:
- Todas as redes virtuais devem ser desvinculadas do circuito do ExpressRoute. Se essa operação falhar, verifique se há redes virtuais vinculadas ao circuito.
- Se o estado de provisionamento do provedor de serviço de circuito de ExpressRoute for Provisionando ou Provisionado, você deverá trabalhar com seu provedor de serviços para que ele desprovisione o circuito. Continuaremos a reservar recursos e a cobrar de você até que o provedor de serviços complete o desprovisionamento do circuito e nos notifique.
- Se o provedor de serviços tiver desprovisionado o circuito (ou seja, se o estado de provisionamento do provedor de serviços tiver sido definido como Não provisionado), então você poderá excluir o circuito. A cobrança da interrupção do circuito.
Limpar os recursos
Você pode excluir o circuito do ExpressRoute executando o comando a seguir:
az network express-route delete -n MyCircuit -g ExpressRouteResourceGroup
Próximas etapas
Depois de criar o circuito e provisioná-lo com o provedor, prossiga para a próxima etapa a fim de configurar o emparelhamento: