Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Um mit einem Event Hub in einem Namespace zu kommunizieren, benötigen Sie eine Verbindungszeichenfolge für den Namespace oder den Event Hub. Wenn Sie in Ihrer Anwendung eine Verbindungszeichenfolge für den Namespace verwenden, verfügt die Anwendung über die bereitgestellten Zugriffsrechte (Verwalten, Lesen oder Schreiben) für alle Event Hubs im Namespace. Wenn du eine Verbindungszeichenfolge zum Event Hub verwendest, hast du den bereitgestellten Zugriff auf diesen speziellen Event Hub.
Die Verbindungszeichenfolge eines Namespace enthält die folgenden eingebetteten Komponenten:
- Vollqualifizierter Domänenname des von Ihnen erstellten Event Hubs-Namespace (enthält den Namen des Event Hubs-Namespace, gefolgt von
servicebus.windows.net) - Name des Schlüssels für den gemeinsamen Zugriff
- Wert des Schlüssels für den gemeinsamen Zugriff
Der Verbindungsstring für einen Namespace sieht wie folgt aus:
Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>
Der Verbindungszeichenfolge für einen Event Hub hat eine zusätzliche Komponente, nämlich EntityPath=<EventHubName>.
Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>;EntityPath=<EventHubName>
Dieser Artikel zeigt Ihnen, wie Sie eine Verbindungszeichenfolge zu einem Namespace oder einem bestimmten Ereignis-Hub mithilfe des Azure-Portals, der PowerShell oder der CLI abrufen können.
Voraussetzungen
- Ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
- Ein Event Hubs-Namensraum und ein Event Hub. Falls Sie keine haben, siehe Quickstart: Erstellen Sie einen Event Hub über das Azure-Portal.
- Um Azure PowerShell oder die Azure CLI zu verwenden, verwenden Sie Azure Cloud Shell oder installieren Sie Azure PowerShell oder die Azure CLI lokal.
Azure-Portal
Verbindungszeichenfolge für einen Namespace
Melden Sie sich im Azure-Portal an.
Im Suchfeld oben im Portal geben Sie Event Hubs ein und wählen Sie dann aus den Ergebnissen Event Hubs aus.
In der Liste der Event Hubs-Namensräume wählen Sie Ihren Namensraum aus.
Auf der Event Hubs-Namensraumseite wählen Sie im linken Menü unter EinstellungenShared Access Policies aus.
Wählen Sie in der Liste der Richtlinien eine Shared-Access-Richtlinie aus. Die Standardrichtlinie heißt RootManageSharedAccessKey. Du kannst auch eine Richtlinie mit den entsprechenden Berechtigungen hinzufügen (Senden, Listen) und diese Richtlinie verwenden.
Wählen Sie neben dem Feld Verbindungszeichenfolge – Primärschlüssel die Schaltfläche Kopieren aus.
Verbindungszeichenfolge für einen bestimmten Event Hub in einem Namespace
Dieser Abschnitt enthält Schritte, um eine Verbindungszeichenfolge zu einem bestimmten Event Hub in einem Namespace zu erhalten.
Auf der Seite Event Hubs Namespace wählen Sie Event Hubs unter Entitäten im linken Menü aus und wählen Sie dann Ihren Event Hub.
Wählen Sie auf der Seite Event-Hubs-Instanz im linken Menü unter Einstellungen die Option Gemeinsame Zugriffsrichtlinien aus.
Für einen Event-Hub gibt es keine Standardrichtlinie. Erstellen Sie eine Richtlinie mit Zugriff vom Typ Verwalten, Senden oder Lauschen.
Wählen Sie die Richtlinie aus der Liste aus.
Wählen Sie neben dem Feld Verbindungszeichenfolge – Primärschlüssel die Schaltfläche Kopieren aus.
Azure PowerShell
Verwenden Sie das Get-AzEventHubKey-CMDLET, um die Verbindungszeichenfolge für eine bestimmte Richtlinie oder Regel zu erhalten.
Das folgende Beispiel ruft die Verbindungszeichenfolge für einen Namensraum ab.
MyAuthRuleName ist der Name der gemeinsamen Zugangsrichtlinie. Für einen Namensraum ist RootManageSharedAccessKeydie Standardrichtlinie .
Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -AuthorizationRuleName MyAuthRuleName
Das folgende Beispiel ruft die Verbindungszeichenfolge für einen bestimmten Event Hub innerhalb eines Namespace ab:
Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AuthorizationRuleName MyAuthRuleName
Das folgende Beispiel ruft unter Verwendung des Alias die Verbindungszeichenfolge für einen Namespace ab, der Teil einer Konfiguration für georedundante Notfallwiederherstellung ist.
Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -AliasName MyAliasName -AuthorizationRuleName MyAuthRuleName
Azure CLI
Im folgenden Beispiel wird die Verbindungszeichenfolge für einen Namespace abgerufen.
MyAuthRuleName ist der Name der gemeinsamen Zugangsrichtlinie. Für einen Namensraum ist RootManageSharedAccessKeydie Standardrichtlinie .
az eventhubs namespace authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --name RootManageSharedAccessKey
Das folgende Beispiel ruft die Verbindungszeichenfolge für einen bestimmten Event Hub innerhalb eines Namespace ab:
az eventhubs eventhub authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --name MyAuthRuleName
Das folgende Beispiel ruft unter Verwendung des Alias die Verbindungszeichenfolge für einen Namespace ab, der Teil einer Konfiguration für georedundante Notfallwiederherstellung ist.
az eventhubs georecovery-alias authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --alias MyAliasName --name MyAuthRuleName
Weitere Informationen zu Azure-CLI-Befehlen für Event Hubs finden Sie unter Azure-Befehlszeilenschnittstelle für Event Hubs.
Zugehöriger Inhalt
Mehr über Event Hubs erfahren Sie in den folgenden Artikeln: