Compartilhar via

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 escalonado 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 os Hubs de Notificação do Azure?.

Neste início rápido, você criará um hub de notificação usando a CLI do Azure. A primeira seção fornece etapas para criar um namespace dos Hubs de Notificação. A segunda seção fornece etapas para criar um hub de notificação em um namespace existente. Você também aprenderá a criar uma política de acesso personalizada.

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

Pré-requisitos

Importante

Os Hubs de Notificação exigem a 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 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 facilitam organizar e gerenciar os recursos relacionados ao 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 chamado spnhubrg no local eastus com o comando az group create a seguir.

az group create --name spnhubrg --location eastus

Criar um namespace dos 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 do 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 Essa linha lê false se o nome desejado especificado para o namespace não está 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 você forneceu para o comando az notification-hub namespace create não estiver disponível, ou não atender às regras de nomenclatura e restrições para recursos do Azure, a CLI do Azure responderá com a seguinte saída do 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 nome que você tentou não for bem-sucedido, selecione um nome diferente para o novo namespace e execute o az notification-hub namespace create comando novamente.

    Observação

    Desta etapa em diante, você precisará substituir o valor do parâmetro --namespace em cada comando da CLI do Azure copiado deste guia de início rápido.

  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 será 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 az notification-hub create comando novamente usando 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 retorna uma mensagem de erro ou de êxito com cada comando executado; no entanto, ser capaz de consultar uma lista de hubs de notificação é reconfortante. 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ítica e seus respectivos 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. Essa política só deve ser usada no back-end. Use somente Listen políticas de acesso em seu aplicativo cliente.

  2. Se você quiser criar regras de autorização adicionais com nomes significativos, poderá 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 as cadeias de conexão para 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 dos 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.

Limpar os 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óximas etapas

  • Last updated on