Guia de início rápido: criar e modificar um circuito de Rota Expressa usando a CLI do Azure
Este guia de início rápido descreve como criar um circuito de Rota Expressa do Azure 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
- Revise os pré-requisitos e fluxos de trabalho antes de iniciar a configuração.
- Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
- Instale a versão mais recente dos comandos da CLI (2.0 ou posterior). Para obter informações sobre como instalar os comandos da CLI, veja Instalar a CLI do Azure e Introdução à CLI do Azure.
Azure Cloud Shell
O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção | Exemplo/Ligação |
|---|---|
| Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell. |  |
| Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. |  |
| Selecione o botão Cloud Shell na barra de menus, na parte direita 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 comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.
Selecione Enter para executar o código ou comando.
Criar e provisionar um circuito de Rota Expressa
Inicie sessão na sua conta do Azure e selecione a sua subscrição
Para iniciar a configuração, inicie sessão na sua conta do Azure. Se você usar o Cloud Shell Try It, estará conectado automaticamente. Use os exemplos a seguir para ajudá-lo a se conectar:
az login
Verifique as subscrições da conta.
az account list
Selecione a assinatura para a qual você deseja criar um circuito de Rota Expressa.
az account set --subscription "<subscription ID>"
Obtenha a lista de fornecedores, localizações e larguras de banda suportados
Antes de criar um circuito de Rota Expressa, você precisa da lista de provedores de conectividade, locais e opções de largura de banda suportados. O comando az network express-route list-service-providers CLI retorna essas 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 seu provedor de conectividade está listado. Anote as seguintes informações, que você precisa ao criar um circuito:
- Nome
- EmparelhamentoLocais
- Larguras de bandaOferecidas
Agora você está pronto para criar um circuito de Rota Expressa.
Criar um circuito do ExpressRoute
Importante
Seu circuito de Rota Expressa é cobrado a partir do momento em que uma chave de serviço é 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 seu circuito de Rota Expressa. 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 ExpressRoute de 200 Mbps através do Equinix no Vale do Silício. Se você estiver usando um provedor diferente e configurações diferentes, substitua essas informações quando fizer sua solicitação.
Certifique-se de especificar a camada de SKU e a família de SKU corretas:
- A camada de SKU determina se um circuito de Rota Expressa é Local, Standard ou Premium. Você pode especificar Local, *Standard ou Premium.
- A família SKU determina o tipo de faturamento. Você pode especificar MeteredData para um plano de dados monitorados e UnlimitedData para um plano de dados ilimitado. Você pode alterar o tipo de cobrança de MeteredData para UnlimitedData, mas não pode alterar o tipo de UnlimitedData para MeteredData. Um circuito local é apenas UnlimitedData .
Seu circuito de Rota Expressa é cobrado a partir do momento em que uma chave de serviço é emitida. O exemplo a seguir é uma solicitação para 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 contém a chave de serviço.
Listar todos os circuitos de Rota Expressa
Para obter uma lista de todos os circuitos de Rota Expressa que você criou, execute o az network express-route list comando. 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 o comando usando o parâmetro '-h'.
az network express-route list -h
Envie a chave de serviço para seu provedor de conectividade para provisionamento
'ServiceProviderProvisioningState' fornece informações sobre o estado atual do provisionamento no lado do provedor de serviços. 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 de Rota Expressa, o circuito está no seguinte estado:
"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"
O circuito muda para o seguinte estado quando o provedor de conectividade o está habilitando para você:
"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"
Para usar o circuito ExpressRoute, ele deve estar no seguinte estado:
"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled
Verifique periodicamente o estado e o estado da chave do circuito
Verificar o status e o estado da chave de serviço permite que você saiba quando seu provedor provisionou seu circuito. Depois que o circuito tiver sido configurado, ServiceProviderProvisioningState aparecerá como Provisionado, conforme mostrado no exemplo a seguir:
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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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]
Crie sua configuração de roteamento
Para obter instruções passo a passo, consulte o artigo Configuração de roteamento de circuito da Rota Expressa para criar e modificar emparelhamentos de circuitos.
Importante
Estas instruções aplicam-se apenas a circuitos criados com fornecedores de serviços 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 uma VPN IP, como MPLS), seu provedor de conectividade configura e gerencia o roteamento para você.
Ligar uma rede virtual a um circuito ExpressRoute
Em seguida, vincule uma rede virtual ao circuito da Rota Expressa. Use o artigo Vinculando redes virtuais a circuitos de Rota Expressa.
Modificando um circuito de Rota Expressa
Pode modificar determinadas 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 um complemento premium da Rota Expressa para seu circuito de Rota Expressa.
- Você pode aumentar a largura de banda do seu circuito de Rota Expressa, desde que haja capacidade disponível na porta. No entanto, o downgrade da largura de banda de um circuito não é suportado.
- Você pode alterar o plano de medição de Dados monitorados para Dados ilimitados. No entanto, não há suporte para alterar o plano de medição de Dados ilimitados para Dados monitorados.
- Você pode habilitar e desabilitar Permitir operações clássicas.
Para obter mais informações sobre limites e limitações, consulte as Perguntas frequentes sobre a Rota Expressa.
Para habilitar o complemento premium da Rota Expressa
Você pode habilitar o complemento premium ExpressRoute para seu circuito existente usando o seguinte comando:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium
O circuito agora tem os recursos de complemento premium ExpressRoute ativados. Começamos a cobrar o recurso de complemento premium assim que o comando for executado com êxito.
Para desativar o complemento premium ExpressRoute
Importante
Essa operação pode falhar se você estiver usando recursos maiores do que o permitido para o circuito padrão.
Antes de desativar o complemento premium da Rota Expressa, entenda os seguintes critérios:
- Antes de mudar de premium para standard, tem de garantir que o número de redes virtuais que estão ligadas ao circuito é inferior a 10. Se não o fizer, o seu pedido de atualização falha e faturamos-lhe as tarifas premium.
- Todas as redes virtuais noutras regiões geopolíticas têm de ser primeiro desligadas. Se você não remover o link, sua solicitação de atualização falhará e continuaremos a cobrar tarifas premium.
- A sua tabela de rotas tem de ser inferior a 4000 rotas para o peering privado. Se o tamanho da tabela de rotas for maior que 4.000 rotas, a sessão BGP será interrompida. A sessão BGP não é restabelecida até que o número de prefixos anunciados seja inferior a 4.000.
Você pode desativar o complemento premium ExpressRoute 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 ExpressRoute
Para obter as opções de largura de banda suportadas pelo seu provedor, consulte as Perguntas frequentes sobre a Rota Expressa. Você pode escolher qualquer tamanho maior do que o tamanho do seu circuito existente.
Importante
Se houver capacidade inadequada na porta existente, talvez seja necessário recriar o circuito de Rota Expressa. Não pode atualizar o circuito se não existir capacidade adicional disponível nessa localização.
Não é possível reduzir a largura de banda de um circuito de Rota Expressa sem interrupção. O downgrade da largura de banda exige que você desprovisione o circuito da Rota Expressa e, em seguida, reprovisione um novo circuito da Rota Expressa.
Depois de decidir o tamanho necessário, use o seguinte comando para redimensionar seu circuito:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000
Seu circuito é atualizado no lado da Microsoft. Em seguida, você deve entrar em contato com seu provedor de conectividade para atualizar as configurações do lado dele para corresponder a essa alteração. Depois de fazer essa notificação, começamos a cobrar pela opção de largura de banda atualizada.
Para mover o SKU de medido para ilimitado
Você pode alterar a SKU de um circuito de Rota Expressa usando o exemplo a seguir:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData
Para controlar o acesso aos ambientes clássico e do Resource Manager
Analise as instruções em Mover circuitos de Rota Expressa do modelo de implantação clássico para o Resource Manager.
Desprovisionando um circuito de Rota Expressa
Para desprovisionar e excluir um circuito de Rota Expressa, certifique-se de entender os seguintes critérios:
- Todas as redes virtuais têm de estar desassociadas do circuito do ExpressRoute. Se esta operação falhar, verifique se existem redes virtuais ligadas ao circuito.
- Se o estado de provisionamento do provedor de serviços de circuito de Rota Expressa for Provisionamento ou Provisionado, você deverá trabalhar com seu provedor de serviços para desprovisionar o circuito do lado dele. Continuamos a reservar recursos e a cobrar até que o fornecedor de serviços conclua o desaprovisionamento do circuito e nos notifique.
- Se o provedor de serviços tiver desprovisionado o circuito, o que significa que o estado de provisionamento do provedor de serviços será definido como Não provisionado, você poderá excluir o circuito. A faturação da paragem do circuito.
Clean up resources (Limpar recursos)
Você pode excluir seu circuito de Rota Expressa executando o seguinte comando:
az network express-route delete -n MyCircuit -g ExpressRouteResourceGroup
Próximos passos
Depois de criar seu circuito e provisioná-lo com seu provedor, continue para a próxima etapa para configurar o emparelhamento: