Compartilhar via


Criar, alterar ou excluir uma conexão do Serviço de Emparelhamento usando a CLI do Azure

O Serviço de Emparelhamento do Azure é um serviço de rede que aprimora a conectividade do cliente com os serviços em nuvem da Microsoft, como o Microsoft 365, o Dynamics 365, os serviços de SaaS (software como serviço), o Azure ou qualquer serviço da Microsoft acessível por meio da Internet pública.

Neste artigo, você aprenderá a criar, alterar e excluir uma conexão do Serviço de Emparelhamento usando a CLI do Azure. Para saber como gerenciar uma conexão do Serviço de Emparelhamento usando o portal do Azure ou o Azure PowerShell, consulte Criar, alterar ou excluir uma conexão do Serviço de Emparelhamento usando o portal do Azure ou Criar ou alterar uma conexão do Serviço de Emparelhamento usando o PowerShell.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

  • Azure Cloud Shell ou CLI do Azure instalada localmente.

    As etapas desse artigo executam os comandos da CLI do Azure interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Abrir o CloudShell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e colá-lo no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell no portal do Azure.

    Você também pode instalar a CLI do Azure localmente para executar os comandos. Este artigo exige a CLI do Azure versão 2.0.28 ou posterior. Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade. Se você executar a CLI do Azure localmente, entre no Azure usando o comando az login .

  • Um provedor de conectividade. Para obter mais informações, confira Parceiros do Serviço de Emparelhamento.

Registrar uma assinatura com o provedor de recursos e o sinalizador de recursos

Antes de prosseguir para as etapas de criação da conexão do Serviço de Emparelhamento, registre sua assinatura com o provedor de recursos e o sinalizador de recursos usando az feature register e az provider register:

az feature register --namespace Microsoft.Peering --name AllowPeeringService
az provider register --name Microsoft.Peering

Listar locais e provedores do Serviço de Emparelhamento

Use az peering service country list para listar os países/as regiões onde o Serviço de Emparelhamento está disponível e az peering service location list para listar os locais metropolitanos disponíveis em um país/uma região específica onde você pode obter o Serviço de Emparelhamento:

# List the countries/regions available for Peering Service.
az peering service country list --out table
# List metro locations serviced in a country/region
az peering service location list --country "united states" --output table

Use az peering service provider list para obter uma lista de provedores de Serviço de Emparelhamento disponíveis:

az peering service provider list --output table

Criar uma conexão do Serviço de Emparelhamento

Crie uma conexão do Serviço de Emparelhamento usando az peering service create:

az peering service create --location "eastus" --peering-service-name "myPeeringService" --resource-group "myResourceGroup" --peering-service-location "Virginia" --peering-service-provider "Contoso"

Adicionar o prefixo do Serviço de Emparelhamento

Use az peering service prefix create para adicionar o prefixo fornecido a você pelo provedor de conectividade:

az peering service prefix create --peering-service-name "myPeeringService" --prefix-name "myPrefix" --resource-group "myResourceGroup" --peering-service-prefix-key "00000000-0000-0000-0000-000000000000" --prefix "240.0.0.0/32"

Listar todas as conexões dos Serviços de Emparelhamento

Para exibir a lista de todas as conexões do Serviço de Emparelhamento, use az peering service list:

az peering service list --resource-group "myresourcegroup" --output "table"

Listar todos os prefixos de Serviço de Emparelhamento

Para exibir a lista de todos os prefixos do Serviço de Emparelhamento, use az peering service prefix list:

az peering service prefix list --peering-service-name "myPeeringService" --resource-group "myResourceGroup"

Remover o prefixo do Serviço de Emparelhamento

Para remover um prefixo do Serviço de Emparelhamento, use az peering service prefix delete:

az peering service prefix delete --peering-service-name "myPeeringService" --prefix-name "myPrefix" --resource-group "myResourceGroup"

Excluir uma conexão do Serviço de Emparelhamento

Para excluir uma conexão do Serviço de Emparelhamento, use az peering service delete:

az peering service delete --peering-service-name "myPeeringService" --resource-group "myResourceGroup"