Ottenere una stringa di connessione ad Hub eventi

Per comunicare con un hub eventi in uno spazio dei nomi, è necessaria una stringa di connessione per lo spazio dei nomi o l'hub eventi. Se usi una stringa di connessione del namespace nella tua applicazione, l'applicazione dispone dell'accesso specificato (gestione, lettura o scrittura) a tutti gli hub eventi nel namespace. Se usi una stringa di connessione per un hub eventi, disponi dell'accesso fornito a quello specifico hub eventi.

La stringa di connessione per un namespace contiene i seguenti componenti incorporati:

• Nome di dominio completo dello spazio dei nomi di Hub eventi creato (include il nome dello spazio dei nomi di Hub eventi seguito da servicebus.windows.net)
• Nome della chiave di accesso condiviso
• Valore della chiave di accesso condiviso

La stringa di connessione per uno spazio dei nomi è simile al seguente:

Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>

La stringa di connessione per un event hub ha un componente aggiuntivo, cioè, EntityPath=<EventHubName>.

Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>;EntityPath=<EventHubName>

Questo articolo spiega come ottenere una stringa di connessione per connettersi a uno spazio dei nomi o a un hub eventi specifico usando il portale di Azure, PowerShell o l'interfaccia della riga di comando.

Prerequisiti

• Una sottoscrizione di Azure. Se non se ne ha una, creare un account gratuito prima di iniziare.
• Uno spazio dei nomi dell'hub eventi e un hub eventi. Se non li hai, consulta Avvio rapido: Crea un hub eventi utilizzando il portale Azure.
• Per usare Azure PowerShell o interfaccia della riga di comando di Azure, usa Azure Cloud Shell, oppure installa Azure PowerShell o interfaccia della riga di comando di Azure localmente.

Portale di Azure

Stringa di connessione per uno spazio dei nomi

1. Accedi al portale di Azure.

2. Nella casella di ricerca in alto del portale, inserisci Event Hubs e poi seleziona Event Hubs dai risultati.

3. Nell'elenco dei namespace di Event Hubs, seleziona il tuo namespace.

4. Nella pagina namespace degli Hub Event , seleziona Politiche di accesso condiviso nel menu sinistro sotto Impostazioni.

5. Seleziona una policy di accesso condiviso nell'elenco delle policy. La politica predefinita si chiama RootManageSharedAccessKey. Puoi anche aggiungere una policy con i permessi appropriati (Invia, Ascolta) e usare quella policy.

6. Selezionare il pulsante di copia accanto al campo Chiave primaria della stringa di connessione.

   

Stringa di connessione per un hub eventi specifico in uno spazio dei nomi

Questa sezione descrive la procedura per ottenere una stringa di connessione per connettersi a un hub eventi specifico in uno spazio dei nomi.

1. Nella pagina dello spazio dei Hub Eventi , seleziona Hub Eventi sotto Entità nel menu sinistro, e poi seleziona il tuo hub evento.

2. Nella pagina Istanza di Hub eventi selezionare Criteri di accesso condiviso nel menu a sinistra in Impostazioni.

3. Non è disponibile alcun criterio predefinito creato per un hub eventi. Creare un criterio con l'accesso in Gestione, Invio o Ascolto.

4. Selezionare il criterio dall'elenco.

5. Selezionare il pulsante di copia accanto al campo Chiave primaria della stringa di connessione.

   

Azure PowerShell

Usa il cmdlet Get-AzEventHubKey per ottenere la stringa di connessione per una policy o regola specifica.

Il seguente esempio ottiene la stringa di connessione per uno spazio di nomi. MyAuthRuleName è il nome dei criteri di accesso condiviso. Per uno spazio di nomi, la policy predefinita è RootManageSharedAccessKey.

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

Il seguente esempio ottiene la stringa di connessione per uno specifico event hub all'interno di un namespace:

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

L'esempio seguente recupera la stringa di connessione per uno spazio dei nomi che fa parte di una configurazione di ripristino di emergenza geografico, utilizzando il relativo alias.

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

Interfaccia della riga di comando di Azure

Il seguente esempio ottiene la stringa di connessione per uno spazio di nomi. MyAuthRuleName è il nome dei criteri di accesso condiviso. Per uno spazio di nomi, la policy predefinita è RootManageSharedAccessKey.

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

Il seguente esempio ottiene la stringa di connessione per uno specifico event hub all'interno di un namespace:

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

L'esempio seguente recupera la stringa di connessione per uno spazio dei nomi che fa parte di una configurazione di ripristino di emergenza geografico, utilizzando il relativo alias.

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

Per altre informazioni sui comandi dell'interfaccia della riga di comando di Azure per Hub eventi, vedere interfaccia della riga di comando di Azure for Event Hubs (Interfaccia della riga di comando di Azure per Hub eventi).

Contenuti correlati

Puoi saperne di più sugli Event Hubs visitando i seguenti articoli:

• Panoramica di Hub eventi
• Creare un hub eventi