Compartilhar via

Associar o ASN do par à assinatura do Azure usando o PowerShell

  • Artigo

Antes de enviar uma solicitação de emparelhamento, você deve primeiro associar seu ASN à assinatura do Azure usando as etapas deste artigo.

Se preferir, você pode concluir este guia usando o portal do Azure.

Trabalhando com o Azure PowerShell

Para executar os cmdlets, você pode usar o Azure Cloud Shell, um shell interativo gratuito. Ele tem ferramentas do Azure instaladas e configuradas para usar com sua conta. Selecione Copiar para copiar o código e colá-lo no Cloud Shell. Em seguida, selecione Enter para executá-lo. Há algumas maneiras de inicializar o Cloud Shell:

Método de inicialização Captura de tela
Abra o Cloud Shell em seu navegador. https://shell.azure.com/powershell
Selecione o botão Cloud Shell na barra de ferramentas no canto superior direito do portal do Azure. Cloud Shell in the portal

Se você não quiser usar o Azure Cloud Shell, poderá instalar o PowerShell localmente em vez disso. Se você optar por instalar e usar o PowerShell localmente, instale a versão mais recente dos cmdlets do PowerShell do Azure Resource Manager. Os cmdlets do PowerShell são atualizados com frequência. Você normalmente precisa atualizar seus cmdlets do PowerShell para obter a funcionalidade mais recente do recurso. Caso contrário, você poderá encontrar problemas.

Para encontrar a versão do PowerShell que você está executando localmente, use o cmdlet 'Get-Module -ListAvailable Az'. Para atualizar, consulte Instalar o módulo do Azure PowerShell. Para obter mais informações, confira como instalar e configurar o Azure PowerShell.

Se você usa o PowerShell no macOS, siga as etapas em Instalando o PowerShell no MacOS.

Criar PeerASN para associar seu ASN à assinatura do Azure

Entre na sua conta do Azure e selecione sua assinatura

Antes de começar a configuração, instale e importe os módulos necessários. Você precisa de privilégios de Administrador para instalar módulos no PowerShell.

  1. Instale e importe o módulo Az.

    Install-Module Az -AllowClobber
Import-Module Az

  2. Instale e importe o módulo Az.Peering.

    Install-Module -Name Az.Peering -AllowClobber
Import-Module Az.Peering

  3. Verifique se os módulos foram importados corretamente usando este comando:

    Get-Module

  4. Conecte à sua conta do Azure usando este comando:

    Connect-AzAccount

  5. Verifique as assinaturas da conta e selecione a assinatura na qual você quer criar um emparelhamento.

    Get-AzSubscription
Select-AzSubscription -SubscriptionId "subscription-id"

  6. Se você ainda não tiver um grupo de recursos, deverá criar um antes de criar um emparelhamento. Faça isso ao executar o seguinte comando:

    New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"

Importante

Se você ainda não associou o ASN e a assinatura, siga as etapas em Associar ASN de Pares. Essa ação é necessária para solicitar um emparelhamento.

Observação

O local de um grupo de recursos é independente do local em que você opta por configurar um emparelhamento.  

Registrar-se para o provedor de recursos de emparelhamento

Registre-se para provedor de recursos de emparelhamento em sua assinatura usando Register-AzResourceProvider. Se você não executar isso, os recursos do Azure necessários para configurar o emparelhamento não estarão acessíveis.

Register-AzResourceProvider -ProviderNamespace Microsoft.Peering

Você pode verificar o status do registro usando Get-AzResourceProvider:

Get-AzResourceProvider -ProviderNamespace Microsoft.Peering

Importante

Aguarde o RegistrationState mudar para "Registrado" antes de continuar. Pode levar de 5 a 30 minutos após a execução do comando.

Atualizar as informações de pares associadas a esta assinatura

Atualize as informações de mesmo nível associadas a esta assinatura usando New-AzPeerAsn:

$contactDetails = New-AzPeerAsnContactDetail -Role Noc -Email "noc@contoso.com" -Phone "+1 (555) 555-5555"
New-AzPeerAsn -Name "Contoso_1234" -PeerName "Contoso" -PeerAsn 1234 -ContactDetail $contactDetails

Observação

– O nome corresponde ao nome do recurso e pode ser qualquer um que você escolher. No entanto, -peerName corresponde ao nome da sua empresa e precisa ser o mais próximo possível do seu perfil de PeeringDB. Observe que o valor do -peerName dá suporte apenas aos caracteres a-z, A-Z e espaço.

Uma assinatura pode ter vários ASNs. Atualize as informações de emparelhamento para cada ASN. O "nome" precisa ser exclusivo em cada ASN.

Espera-se que os pares tenham um perfil completo e atualizado em PeeringDB. Usamos essas informações durante o registro para validar os detalhes do par, como informações do NOC, informações de contato técnico e sua presença nos recursos de emparelhamento, etc.

No lugar de {subscriptionId} na saída, a ID de assinatura real é exibida.

Ver o status de um PeerASN

Verifique o estado de Validação ASN usando Get-AzPeerAsn:

Get-AzPeerAsn

Abaixo está um exemplo de resposta:

PeerContactInfo : Microsoft.Azure.PowerShell.Cmdlets.Peering.Models.PSContactInfo
PeerName        : Contoso
ValidationState : Approved
PeerAsnProperty : 1234
Name            : Contoso_1234
Id              : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/Contoso_1234
Type            : Microsoft.Peering/peerAsns

Importante

Aguarde até que o ValidationState passe a ser "Aprovado" antes de enviar uma solicitação de emparelhamento. Podem ser necessárias 12 horas para essa aprovação.

Modificar PeerAsn

Você pode modificar as informações de contato do NOC a qualquer momento usando Set-AzPeerAsn:

Set-AzPeerAsn -Name Contoso_1234 -Email "newemail@test.com" -Phone "1800-000-0000"

Excluir PeerAsn

A exclusão de um PeerASN não é suportada no momento. Se você precisar excluir o PeerASN, entre em contato com Emparelhamento da Microsoft.

Próximas etapas