Partilhar via

Guia de início rápido: criar um hub de notificação do Azure usando a CLI do Azure

Os Hubs de Notificação do Azure fornecem um mecanismo de push fácil de usar e dimensionado que permite enviar notificações para qualquer plataforma (iOS, Android, Windows, Kindle, Baidu, etc.) de qualquer back-end (nuvem ou local). Para obter mais informações sobre o serviço, consulte O que são Hubs de Notificação do Azure?.

Neste início rápido, você cria um hub de notificação usando a CLI do Azure. A primeira seção fornece etapas para criar um namespace de Hubs de Notificação. A segunda seção fornece etapas para criar um hub de notificação em um namespace existente. Você também aprende 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 requerem a versão 2.0.67 ou posterior da CLI do Azure. 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.

Criar um grupo de recursos

Os Hubs de Notificação do Azure, como todos os recursos do Azure, devem ser implantados em um grupo de recursos. Os grupos de recursos permitem organizar e gerenciar recursos relacionados do Azure. Consulte O que é o Azure Resource Manager para saber mais sobre grupos de recursos.

Para este início rápido, crie um grupo de recursos chamado spnhubrg no local eastus com o seguinte comando az group create .

az group create --name spnhubrg --location eastus

Criar um namespace de Hubs de Notificação

  1. Crie um namespace para seus hubs de notificação.

    Um namespace contém um ou mais hubs e o nome deve ser exclusivo em todas as assinaturas do Azure e ter pelo menos seis caracteres de comprimento. Para verificar a disponibilidade de um nome, use o comando az notification-hub namespace check-availability .

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

    A CLI do Azure responde à sua solicitação de disponibilidade exibindo a seguinte saída de console:

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

    Observe a segunda linha na resposta da CLI do Azure, "isAvailable": true. Esta linha lê false se o nome desejado especificado para o namespace não estiver disponível. Depois de confirmar a disponibilidade do nome, execute o comando az notification-hub namespace create para criar seu namespace.

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

    Se o --name que forneceu ao comando az notification-hub namespace create não estiver disponível ou não atender às regras e restrições de nomenclatura para recursos do Azure, a CLI do Azure responderá com a seguinte saída de console:

    #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 você tentou não for bem-sucedido, selecione um nome diferente para seu novo namespace e execute o az notification-hub namespace create comando novamente.

    Observação

    A partir deste ponto em diante, deverá substituir o valor do parâmetro --namespace em cada comando da CLI do Azure copiado desta introdução rápida.

  2. Obtenha uma lista de namespaces.

    Para ver os detalhes sobre seu novo namespace, use o comando az notification-hub namespace list . O --resource-group parâmetro é opcional se você quiser ver todos os namespaces de uma assinatura.

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

Criar hubs de notificação

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

    Um ou mais hubs de notificação agora podem ser criados em seu novo namespace. 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.

    Vários hubs de notificação podem ser criados em um único namespace. Para criar um segundo hub de notificação no mesmo namespace, execute o comando novamente usando um nome de az notification-hub create 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 retorna uma mensagem de êxito ou erro 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 projetado para essa 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 usam a segurança de assinatura de acesso compartilhado por meio do uso de políticas de acesso. Duas políticas são criadas automaticamente quando você cria um hub de notificação. As cadeias de conexão dessas políticas são necessárias para configurar notificações por push. O comando az notification-hub authorization-rule list fornece uma lista de nomes de políticas e seus 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 use a política DefaultFullSharedAccessSignature em seu aplicativo. Esta política destina-se a ser utilizada apenas no seu back-end. Use apenas Listen políticas de acesso em seu aplicativo cliente.

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

    az notification-hub authorization-rule create --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --rights Listen Manage Send

  3. Há dois conjuntos de chaves e cadeias de conexão para cada política de acesso. Você precisará deles mais tarde para configurar um hub de notificação. Para listar as chaves e cadeias de conexão de uma política de acesso dos Hubs de Notificação, use 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

    Observação

    Um namespace de Hubs de Notificação e um hub de notificação têm políticas de acesso separadas. Verifique se você está usando a referência correta da CLI do Azure ao consultar chaves e cadeias de conexão.

Limpeza de recursos

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

az group delete --name spnhubrg

Próximos passos

  • Last updated on