Udostępnij przez

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

Usługa Azure Notification Hubs udostępnia łatwy w użyciu i zautomatyzowany mechanizm powiadomień, który umożliwia wysyłanie powiadomień do dowolnej platformy (iOS, Android, Windows, Kindle, Baidu itp.) z dowolnego zaplecza (chmury lub środowiska lokalnego). 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 Azure, przed rozpoczęciem utwórz darmowe konto.

Wymagania wstępne

Ważne

Usługa Notification Hubs wymaga wersji 2.0.67 lub nowszej interfejsu wiersza polecenia platformy Azure. Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom 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 szybkiego startu 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

Utwórz przestrzeń nazw dla usługi Notification Hubs

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

    Przestrzeń nazw zawiera co najmniej jedno centrum, a jej 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 Azure CLI odpowiada na żądanie dostępności, wyświetlając następujący wynik w 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 Azure CLI. "isAvailable": true 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

    Jeśli --name podany w poleceniu az notification-hub namespace create nie jest dostępny lub nie spełnia reguł i ograniczeń nazewnictwa dla zasobów platformy Azure, Azure CLI odpowiada następującym komunikatem 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óbowana nazwa nie powiedzie się, wybierz inną nazwę nowej przestrzeni nazw i ponownie uruchom az notification-hub namespace create polecenie.

    Uwaga / Notatka

    Od tego kroku musisz zastąpić wartość parametru --namespace w każdym poleceniu interfejsu wiersza polecenia platformy Azure skopiowanego 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 za pośrednictwem zasad dostępu. Dwie zasady są tworzone automatycznie podczas tworzenia centrum powiadomień. Ciągi połączenia z tych zasad są potrzebne do skonfigurowania powiadomień push. Polecenie az notification-hub authorization-rule list zawiera listę nazw zasad i ich 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 każdej zasady 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 / Notatka

    Przestrzeń nazw usługi Notification Hubs i centrum powiadomień mają oddzielne zasady dostępu. Upewnij się, że używasz poprawnej dokumentacji Azure CLI podczas zapytań o klucze i ciągi połączeń.

Uprzątnij zasoby

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

az group delete --name spnhubrg

Dalsze kroki

  • Last updated on