Partilhar via


Início Rápido: Criar um hub de notificação do Azure com a CLI do Azure

Os Hubs de Notificação do Azure oferecem um motor de envio de escalamento horizontal e utilização fácil que lhe permite enviar notificações para qualquer plataforma (iOS, Android, Windows, Kindle, Baidu, etc.) a partir de qualquer back-end (cloud ou no local). Para obter mais informações sobre o serviço, consulte O que são os Hubs de Notificação do Azure?.

Neste início rápido, vai criar um hub de notificação com a CLI do Azure. A primeira secção dá-lhe os passos para criar um espaço de nomes dos Hubs de Notificação. A segunda secção dá-lhe os passos para criar um hub de notificação num espaço de nomes existente. Também pode aprender a criar uma política de acesso personalizada.

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

Importante

Os Hubs de Notificação necessitam da versão 2.0.67 ou posterior da CLI do Azure. Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Criar um grupo de recursos

Os Hubs de Notificação do Azure, como todos os recursos do Azure, têm de ser implementados num grupo de recursos. Os grupos de recursos permitem organizar e gerir recursos relacionados do Azure. Veja O que é o Azure Resource Manager para saber mais sobre grupos de recursos.

Para este início rápido, crie um grupo de recursos com o nome spnhubrg na localização eastus com o seguinte comando az group create .

az group create --name spnhubrg --location eastus

Criar um espaço de nomes dos Hubs de Notificação

  1. Crie um espaço de nomes para os seus hubs de notificação.

    Um espaço de nomes contém um ou mais hubs e o nome tem de ser exclusivo em todas as subscrições do Azure e ter, pelo menos, seis carateres de comprimento. Para verificar a disponibilidade de um nome, utilize o comando az notification-hub namespace check-availability .

    az notification-hub namespace check-availability --name spnhubns
    

    A CLI do Azure responde ao seu pedido de disponibilidade ao apresentar o seguinte resultado da consola:

    {
    "id": "/subscriptions/yourSubscriptionID/providers/Microsoft.NotificationHubs/checkNamespaceAvailability",
    "isAvailable": true,
    "location": null,
    "name": "spnhubns",
    "properties": false,
    "sku": null,
    "tags": null,
    "type": "Microsoft.NotificationHubs/namespaces/checkNamespaceAvailability"
    }
    

    Repare na segunda linha na resposta da CLI do Azure, "isAvailable": true. Esta linha indica false se o nome pretendido para o espaço de nomes não está disponível. Depois de confirmar a disponibilidade do nome, execute o comando az notification-hub namespace create para criar o seu espaço de nomes.

    az notification-hub namespace create --resource-group spnhubrg --name spnhubns  --location eastus --sku Free
    

    Se o --name que forneceu ao comando não estiver disponível ou não cumprir as regras e restrições de Nomenclatura dos recursos do Azure, a CLI do az notification-hub namespace create Azure responde com a seguinte saída da consola:

    #the name is not available
    The specified name is not available. For more information visit https://aka.ms/eventhubsarmexceptions.
    
    #the name is invalid
    The specified service namespace is invalid.
    

    Se o primeiro nome que tentou não for bem-sucedido, selecione um nome diferente para o seu novo espaço de nomes e execute o az notification-hub namespace create comando novamente.

    Nota

    Neste passo em frente, tem de substituir o valor do --namespace parâmetro em cada comando da CLI do Azure que copiar a partir deste início rápido.

  2. Obtenha uma lista de espaços de nomes.

    Para ver os detalhes sobre o novo espaço de nomes, utilize o comando az notification-hub namespace list . O --resource-group parâmetro é opcional se quiser ver todos os espaços de nomes de uma subscrição.

    az notification-hub namespace list --resource-group spnhubrg
    

Criar hubs de notificação

  1. Crie o seu primeiro hub de notificação.

    Um ou mais hubs de notificação podem agora ser criados no seu novo espaço de nomes. Execute o comando az notification-hub create para criar um hub de notificação.

    az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name spfcmtutorial1nhub --location eastus
    
  2. Crie um segundo hub de notificação.

    Podem ser criados vários hubs de notificação num único espaço de nomes. Para criar um segundo hub de notificação no mesmo espaço de nomes, execute o az notification-hub create comando novamente com um nome de hub diferente.

    az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name mysecondnhub --location eastus 
    
  3. Obtenha uma lista de hubs de notificação.

    A CLI do Azure devolve uma mensagem de erro ou êxito com cada comando executado; no entanto, ser capaz de consultar uma lista de hubs de notificação é tranquilizador. O comando az notification-hub list foi concebido para esta finalidade.

    az notification-hub list --resource-group spnhubrg --namespace-name spnhubns --output table
    

Trabalhar com políticas de acesso

  1. Os Hubs de Notificação do Azure utilizam a segurança da assinatura de acesso partilhado através da utilização de políticas de acesso. Duas políticas são criadas automaticamente quando cria um hub de notificação. As cadeias de ligação destas políticas são necessárias para configurar notificações push. O comando az notification-hub authorization-rule list fornece uma lista de nomes de políticas e respetivos grupos de recursos.

    az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
    

    Importante

    Não utilize a política DefaultFullSharedAccessSignature na sua aplicação. Esta política destina-se a ser utilizada apenas no seu back-end. Utilize apenas Listen políticas de acesso na sua aplicação cliente.

  2. Se quiser criar regras de autorização adicionais com nomes significativos, pode criar e personalizar a sua própria política de acesso com o comando az notification-hub authorization-rule create . O --rights parâmetro é uma lista delimitada por espaço das permissões que pretende atribuir.

    az notification-hub authorization-rule create --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --rights Listen Manage Send
    
  3. Existem dois conjuntos de chaves e cadeias de ligação para cada política de acesso. Precisará deles mais tarde para configurar um hub de notificação. Para listar as chaves e cadeias de ligação de uma política de acesso dos Hubs de Notificação, utilize o comando az notification-hub authorization-rule list-keys .

    # query the keys and connection strings for DefaultListenSharedAccessSignature
    az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name DefaultListenSharedAccessSignature --output table
    
    # query the keys and connection strings for a custom policy
    az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --output table
    

    Nota

    Um espaço de nomes dos Hubs de Notificação e um hub de notificação têm políticas de acesso separadas. Certifique-se de que está a utilizar a referência correta da CLI do Azure ao consultar chaves e cadeias de ligação.

Limpar os recursos

Quando já não for necessário, utilize o comando az group delete para remover o grupo de recursos e todos os recursos relacionados:

az group delete --name spnhubrg

Passos seguintes