Partilhar via


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

O Serviço de Emparelhamento do Azure é um serviço de rede que melhora a conectividade do cliente com serviços de nuvem da Microsoft, como Microsoft 365, Dynamics 365, serviços de software como serviço (SaaS), Azure ou quaisquer serviços da Microsoft acessíveis através da Internet pública.

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

Prerequisites

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

  • Azure Cloud Shell ou Azure CLI instalado localmente.

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

    Você também pode instalar a CLI do Azure localmente para executar os comandos. Este artigo requer a CLI do Azure versão 2.0.28 ou posterior. Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar 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, consulte Parceiros do Serviço de Peering.

Registe a sua subscrição com o fornecedor de recursos e o sinalizador de funcionalidades

Antes de prosseguir para as etapas de criação da conexão do Serviço de Emparelhamento, registe a sua subscrição com o fornecedor de recursos e sinalizador de funcionalidades 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 de serviços do Serviço de Emparelhamento

Use az peering service country list para listar os países/regiões onde o Serviço de Emparelhamento está disponível e az peering service location list para listar as localizações metropolitanas disponíveis num país/região específico onde 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 a lista dos provedores de serviços de Peering disponíveis:

az peering service provider list --output table

Criar uma ligação de Peering Service

Criar uma ligação do Peering Service 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 de Peering Services

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 do Peering Service.

Para exibir a lista de todos os prefixos do Serviço de Peering, 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 Peering

Para remover um prefixo do Peering Service, 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 de serviço de emparelhamento

Para eliminar uma ligação Peering Service, use az peering service delete:

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