Freigeben über

Schnellstart: Erstellen eines Azure-Benachrichtigungshubs mithilfe der Azure CLI

Azure Notification Hubs bieten ein einfach zu bedienendes und skaliertes Pushmodul, mit dem Sie Benachrichtigungen an eine beliebige Plattform (iOS, Android, Windows, Kindle, Baidu usw.) von jedem Back-End (Cloud oder lokal) senden können. Weitere Informationen zum Dienst finden Sie unter Was ist Azure Notification Hubs?.

In dieser Schnellstartanleitung erstellen Sie einen Benachrichtigungshub mithilfe der Azure CLI. Im ersten Abschnitt werden Schritte zum Erstellen eines Notification Hubs-Namespaces beschrieben. Der zweite Abschnitt enthält Schritte zum Erstellen eines Benachrichtigungshubs in einem vorhandenen Namespace. Außerdem erfahren Sie, wie Sie eine benutzerdefinierte Zugriffsrichtlinie erstellen.

Wenn Sie noch kein Azure-Abonnement haben, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.

Voraussetzungen

Von Bedeutung

Für Benachrichtigungshubs ist Version 2.0.67 oder höher der Azure CLI erforderlich. Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um auf die neueste Version zu aktualisieren.

Erstellen einer Ressourcengruppe

Azure Notification Hubs müssen wie alle Azure-Ressourcen in einer Ressourcengruppe bereitgestellt werden. Mit Ressourcengruppen können Sie verwandte Azure-Ressourcen organisieren und verwalten. Weitere Informationen zu Ressourcengruppen finden Sie unter "Was ist Azure Resource Manager ".

Erstellen Sie für diesen Schnellstart eine Ressourcengruppe mit dem Namen spnhubrg in der Region eastus mit dem folgenden Befehl az group create.

az group create --name spnhubrg --location eastus

Erstellen eines Notification Hubs-Namespaces

  1. Erstellen Sie einen Namespace für Ihre Benachrichtigungshubs.

    Ein Namespace enthält einen oder mehrere Hubs, und der Name muss für alle Azure-Abonnements eindeutig sein und mindestens sechs Zeichen lang sein. Um die Verfügbarkeit eines Namens zu überprüfen, verwenden Sie den Az notification-hub Namespace Check-Availability-Befehl .

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

    Azure CLI antwortet auf Ihre Verfügbarkeitsanforderung, indem die folgende Konsolenausgabe angezeigt wird:

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

    Beachten Sie die zweite Zeile in der Azure CLI-Antwort, "isAvailable": true. Diese Zeile liest false , wenn der gewünschte Name, den Sie für den Namespace angegeben haben, nicht verfügbar ist. Nachdem Sie die Verfügbarkeit des Namens bestätigt haben, führen Sie den Befehl "az notification-hub namespace create " aus, um Ihren Namespace zu erstellen.

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

    Wenn die von Ihnen an den --name-Befehl übergebene az notification-hub namespace create nicht verfügbar ist oder nicht die Benennungsregeln und Einschränkungen für Azure-Ressourcen erfüllt, antwortet Azure CLI mit der folgenden Konsolenausgabe:

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

    Wenn der von Ihnen ausprobierte Vorname nicht erfolgreich ist, wählen Sie einen anderen Namen für den neuen Namespace aus, und führen Sie den az notification-hub namespace create Befehl erneut aus.

    Hinweis

    Ab diesem Schritt müssen Sie den Wert des --namespace-Parameters in jedem Azure CLI-Befehl ersetzen, den Sie aus dieser Schnellstartanleitung kopieren.

  2. Erhalte eine Liste von Namespaces.

    Um die Details zu Ihrem neuen Namespace anzuzeigen, verwenden Sie den Befehl az notification-hub namespace list. Der --resource-group Parameter ist optional, wenn Sie alle Namespaces für ein Abonnement anzeigen möchten.

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

Erstellen von Benachrichtigungshubs

  1. Erstellen Sie Ihren ersten Benachrichtigungshub.

    Ein oder mehrere Benachrichtigungshubs können jetzt in Ihrem neuen Namespace erstellt werden. Führen Sie den Befehl "az notification-hub create " aus, um einen Benachrichtigungshub zu erstellen.

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

  2. Erstellen Sie einen zweiten Benachrichtigungshub.

    Mehrere Benachrichtigungshubs können in einem einzigen Namespace erstellt werden. Um einen zweiten Benachrichtigungshub im selben Namespace zu erstellen, führen Sie den az notification-hub create Befehl erneut unter Verwendung eines anderen Hubnamens aus.

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

  3. Eine Liste von Benachrichtigungshubs abrufen.

    Azure CLI gibt entweder eine Erfolgs- oder Fehlermeldung mit jedem ausgeführten Befehl zurück; Die Möglichkeit, eine Liste der Benachrichtigungshubs abzufragen, ist jedoch beruhigend. Der Befehl "az notification-hub list " wurde für diesen Zweck entwickelt.

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

Arbeiten mit Zugriffsrichtlinien

  1. Azure Notification Hubs nutzt SAS-Sicherheit (Shared Access Signature) durch die Verwendung von Zugriffsrichtlinien. Beim Erstellen eines Benachrichtigungshubs werden zwei Richtlinien automatisch erstellt. Die Verbindungszeichenfolgen aus diesen Richtlinien sind erforderlich, um Pushbenachrichtigungen zu konfigurieren. Der Befehl "az notification-hub authorization-rule list" liefert eine Liste von Richtliniennamen und deren jeweiligen Ressourcengruppen.

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

    Von Bedeutung

    Verwenden Sie die DefaultFullSharedAccessSignature-Richtlinie nicht in Ihrer Anwendung. Diese Richtlinie soll nur in Ihrem Backend verwendet werden. Verwenden Sie nur Listen Zugriffsrichtlinien in Ihrer Clientanwendung.

  2. Wenn Sie zusätzliche Autorisierungsregeln mit aussagekräftigen Namen erstellen möchten, können Sie Ihre eigene Zugriffsrichtlinie erstellen und anpassen, indem Sie den Befehl "az notification-hub authorization-rule create " verwenden. Der --rights Parameter ist eine durch Leerzeichen getrennte Liste der Berechtigungen, die Sie zuweisen möchten.

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

  3. Es gibt zwei Sätze von Schlüsseln und Verbindungszeichenfolgen für jede Zugriffsrichtlinie. Sie benötigen sie später, um einen Benachrichtigungshub zu konfigurieren. Um die Schlüssel und Verbindungszeichenfolgen für eine Zugriffsrichtlinie für Benachrichtigungshubs auflisten zu können, verwenden Sie den Befehl 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

    Hinweis

    Ein Benachrichtigungshub-Namespace und ein Benachrichtigungshub verfügen über separate Zugriffsrichtlinien. Stellen Sie sicher, dass Sie beim Abfragen nach Schlüsseln und Verbindungszeichenfolgen die richtige Azure CLI-Referenz verwenden.

Bereinigen von Ressourcen

Wenn sie nicht mehr benötigt wird, verwenden Sie den Befehl " az group delete ", um die Ressourcengruppe und alle zugehörigen Ressourcen zu entfernen:

az group delete --name spnhubrg

Nächste Schritte

  • Last updated on