Abrufen einer Event Hubs-Verbindungszeichenfolge

  • Artikel

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 eine Verbindungszeichenfolge zum Namespace von Ihrer Anwendung aus verwenden, hat die Anwendung den vorgesehenen Zugriff (verwalten, lesen oder schreiben) auf alle Event-Hubs im Namespace. Wenn Sie eine Verbindungszeichenfolge zum Ereignis-Hub verwenden, haben Sie den vorgesehenen Zugriff auf diesen speziellen Ereignis-Hub.

Die Verbindungszeichenfolge für einen Namensraum enthält die folgenden 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>

Die Verbindungszeichenfolge für einen Event-Hub enthält eine zusätzliche Komponente. Das ist, 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.

Azure-Portal

Verbindungszeichenfolge für einen Namespace

  1. Melden Sie sich beim Azure-Portalan.

  2. Wählen Sie im linken Navigationsmenü die Option Alle Dienste aus.

  3. Wählen Sie im Abschnitt Analytics die Option Event Hubs aus.

  4. Wählen Sie in der Liste der Event Hubs Ihren Event Hub aus.

  5. Wählen Sie auf der Seite Event Hubs-Namespace im linken Menü die Option Freigegebene Zugriffsrichtlinien aus.

  6. Wählen Sie in der Liste der Richtlinien eine freigegebene Zugriffsrichtlinie aus. Die Standardrichtlinie hat den Namen RootManageSharedAccessPolicy. Sie können eine Richtlinie mit entsprechenden Berechtigungen (Senden, Abhören) hinzufügen und diese Richtlinie verwenden.

    Freigegebene Zugriffsrichtlinien für Event Hubs

  7. Wählen Sie neben dem Feld Verbindungszeichenfolge – Primärschlüssel die Schaltfläche Kopieren aus.

    Event Hubs – Abrufen der Verbindungszeichenfolge

Verbindungszeichenfolge für einen bestimmten Ereignis-Hub in einem Namensraum

Dieser Abschnitt enthält Schritte, um eine Verbindungszeichenfolge zu einem bestimmten Event Hub in einem Namespace zu erhalten.

  1. Wählen Sie auf der Seite Ereignishub-Namensraum den Ereignishub im unteren Fensterbereich aus.

  2. Wählen Sie auf der Seite Event-Hubs-Instanz im linken Menü die Option Gemeinsame Zugriffsrichtlinien.

  3. Für einen Event-Hub gibt es keine Standardrichtlinie. Erstellen Sie eine Richtlinie mit Zugriff vom Typ Verwalten, Senden oder Lauschen.

  4. Wählen Sie die Richtlinie aus der Liste aus.

  5. Wählen Sie neben dem Feld Verbindungszeichenfolge – Primärschlüssel die Schaltfläche Kopieren aus.

    Verbindungszeichenfolge für einen bestimmten Event Hub

Azure PowerShell

Sie können den Get-AzEventHubKey verwenden, um die Verbindungszeichenfolge für die spezifische Richtlinie/Regel zu erhalten.

Hier ein Beispielbefehl zum Abrufen der Verbindungszeichenfolge für einen Namespace. MyAuthRuleName ist der Name der gemeinsamen Zugangsrichtlinie. Für einen Namespace gibt es einen Standard-Namespace: RootManageSharedAccessKey.

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -AuthorizationRuleName MyAuthRuleName

Hier ist ein Beispielbefehl zum Abrufen der Verbindungszeichenfolge für einen bestimmten Ereignishub innerhalb eines Namensraums:

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AuthorizationRuleName MyAuthRuleName

Hier ist ein Beispielbefehl zum Abrufen der Verbindungszeichenfolge für einen Event-Hub in einem Geo-DR-Cluster, der einen Alias hat.

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AliasName MyAliasName -Name MyAuthRuleName

Azure CLI

Hier ein Beispielbefehl zum Abrufen der Verbindungszeichenfolge für einen Namespace. MyAuthRuleName ist der Name der gemeinsamen Zugangsrichtlinie. Für einen Namespace gibt es einen Standard-Namespace: RootManageSharedAccessKey

az eventhubs namespace authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --name RootManageSharedAccessKey

Hier ist ein Beispielbefehl zum Abrufen der Verbindungszeichenfolge für einen bestimmten Ereignishub innerhalb eines Namensraums:

az eventhubs eventhub authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --name MyAuthRuleName

Hier ist ein Beispielbefehl zum Abrufen der Verbindungszeichenfolge für einen Event-Hub in einem Geo-DR-Cluster, der einen Alias hat.

az eventhubs georecovery-alias authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --alias-name MyAliasName --name MyAuthRuleName

Weitere Informationen zu Azure-CLI-Befehlen für Event Hubs finden Sie unter Azure-Befehlszeilenschnittstelle für Event Hubs.

Nächste Schritte

Weitere Informationen zu Event Hubs finden Sie unter den folgenden Links: