Szybki start: tworzenie centrum powiadomień platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

Usługa Azure Notification Hubs oferuje łatwy w użyciu, skalowany w poziomie mechanizm, który umożliwia wysyłanie powiadomień do dowolnej platformy (iOS, Android, Windows, Kindle, Baidu, itp.) z poziomu dowolnego zaplecza (w chmurze lub w środowisku lokalnym). Aby uzyskać więcej informacji na temat usługi, zobacz Co to jest usługa Azure Notification Hubs?

W tym przewodniku Szybki start utworzysz centrum powiadomień przy użyciu interfejsu wiersza polecenia platformy Azure. Pierwsza sekcja zawiera kroki tworzenia przestrzeni nazw usługi Notification Hubs. Druga sekcja zawiera kroki tworzenia centrum powiadomień w istniejącej przestrzeni nazw. Dowiesz się również, jak utworzyć niestandardowe zasady dostępu.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Wymagania wstępne

Ważne

Usługa Notification Hubs wymaga wersji 2.0.67 lub nowszej interfejsu wiersza polecenia platformy Azure. Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

Tworzenie grupy zasobów

Usługa Azure Notification Hubs, podobnie jak wszystkie zasoby platformy Azure, musi zostać wdrożona w grupie zasobów. Grupy zasobów umożliwiają organizowanie powiązanych zasobów platformy Azure i zarządzanie nimi. Zobacz Co to jest usługa Azure Resource Manager, aby dowiedzieć się więcej o grupach zasobów.

W tym przewodniku Szybki start utwórz grupę zasobów o nazwie spnhubrg w lokalizacji eastus za pomocą następującego polecenia az group create .

az group create --name spnhubrg --location eastus

Tworzenie przestrzeni nazw usługi Notification Hubs

  1. Utwórz przestrzeń nazw dla centrów powiadomień.

    Przestrzeń nazw zawiera co najmniej jeden koncentrator, a nazwa musi być unikatowa we wszystkich subskrypcjach platformy Azure i mieć co najmniej sześć znaków. Aby sprawdzić dostępność nazwy, użyj polecenia az notification-hub namespace check-availability .

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

    Interfejs wiersza polecenia platformy Azure odpowiada na żądanie dostępności, wyświetlając następujące dane wyjściowe konsoli:

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

    Zwróć uwagę na drugi wiersz w odpowiedzi "isAvailable": trueinterfejsu wiersza polecenia platformy Azure. Ten wiersz odczytuje false , jeśli żądana nazwa określona dla przestrzeni nazw jest niedostępna. Po potwierdzeniu dostępności nazwy uruchom polecenie az notification-hub namespace create , aby utworzyć przestrzeń nazw.

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

    --name Jeśli podane polecenie az notification-hub namespace create nie jest dostępne lub nie spełnia reguł i ograniczeń nazewnictwa dla zasobów platformy Azure, interfejs wiersza polecenia platformy Azure odpowiada następującymi danymi wyjściowymi konsoli:

    #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.

    Jeśli wypróbowane imię nie powiedzie się, wybierz inną nazwę nowej przestrzeni nazw i ponownie uruchom az notification-hub namespace create polecenie.

    Uwaga

    Z tego kroku należy zastąpić wartość parametru --namespace w każdym poleceniu interfejsu wiersza polecenia platformy Azure skopiowane z tego przewodnika Szybki start.

  2. Pobierz listę przestrzeni nazw.

    Aby wyświetlić szczegółowe informacje o nowej przestrzeni nazw, użyj polecenia az notification-hub namespace list . Parametr --resource-group jest opcjonalny, jeśli chcesz wyświetlić wszystkie przestrzenie nazw dla subskrypcji.

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

Tworzenie centrów powiadomień

  1. Utwórz pierwsze centrum powiadomień.

    Co najmniej jedno centrum powiadomień można teraz utworzyć w nowej przestrzeni nazw. Uruchom polecenie az notification-hub create , aby utworzyć centrum powiadomień.

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

  2. Utwórz drugie centrum powiadomień.

    W jednej przestrzeni nazw można utworzyć wiele centrów powiadomień. Aby utworzyć drugie centrum powiadomień w tej samej przestrzeni nazw, uruchom az notification-hub create ponownie polecenie przy użyciu innej nazwy centrum.

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

  3. Pobierz listę centrów powiadomień.

    Interfejs wiersza polecenia platformy Azure zwraca komunikat o powodzeniu lub błędzie z każdym wykonanym poleceniem; jednak możliwość wykonywania zapytań dotyczących listy centrów powiadomień jest uspokajająca. Polecenie az notification-hub list zostało zaprojektowane w tym celu.

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

Praca z zasadami dostępu

  1. Usługa Azure Notification Hubs używa zabezpieczeń sygnatury dostępu współdzielonego przy użyciu zasad dostępu. Dwie zasady są tworzone automatycznie podczas tworzenia centrum powiadomień. Parametry połączenia z tych zasad są potrzebne do skonfigurowania powiadomień wypychanych. Polecenie az notification-hub authorization-rule list udostępnia listę nazw zasad i odpowiednich grup zasobów.

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

    Ważne

    Nie używaj zasad DefaultFullSharedAccessSignature w aplikacji. Te zasady mają być używane tylko w zapleczu. Używaj tylko Listen zasad dostępu w aplikacji klienckiej.

  2. Jeśli chcesz utworzyć dodatkowe reguły autoryzacji z zrozumiałymi nazwami, możesz utworzyć i dostosować własne zasady dostępu przy użyciu polecenia az notification-hub authorization-rule create . Parametr --rights jest rozdzielaną spacją listą uprawnień, które chcesz przypisać.

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

  3. Istnieją dwa zestawy kluczy i parametrów połączenia dla poszczególnych zasad dostępu. Będą one potrzebne później do skonfigurowania centrum powiadomień. Aby wyświetlić listę kluczy i parametrów połączenia dla zasad dostępu usługi Notification Hubs, użyj polecenia 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

    Uwaga

    Przestrzeń nazw usługi Notification Hubs i centrum powiadomień mają oddzielne zasady dostępu. Upewnij się, że używasz poprawnej dokumentacji interfejsu wiersza polecenia platformy Azure podczas wykonywania zapytań dotyczących kluczy i parametrów połączenia.

Czyszczenie zasobów

Gdy grupa zasobów nie jest już potrzebna, użyj polecenia az group delete , aby usunąć grupę zasobów i wszystkie powiązane zasoby:

az group delete --name spnhubrg

Następne kroki