Obtención de una cadena de conexión de Event Hubs

  • Artículo

Para comunicarse con un centro de eventos en un espacio de nombres, necesita una cadena de conexión para el espacio de nombres o el centro de eventos. Si usa una cadena de conexión para el espacio de nombres de la aplicación, la aplicación tendrá el acceso proporcionado (administrar, leer o escribir) a todos los centros de eventos del espacio de nombres. Si usa una cadena de conexión para el centro de eventos, tendrá acceso proporcionado a ese centro de eventos específico.

La cadena de conexión para el espacio de nombres tiene los siguientes componentes insertados:

  • El nombre de dominio completo del espacio de nombres de Event Hubs que creó (este incluye el espacio de nombres de Event Hubs seguido de servicebus.windows.net)
  • El nombre de la clave de acceso compartido
  • El valor de la clave de acceso compartido

La cadena de conexión de un espacio de nombres tiene el siguiente aspecto:

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

La cadena de conexión de un centro de eventos tiene un componente adicional. Es decir, EntityPath=<EventHubName>.

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

En este artículo se muestra cómo obtener una cadena de conexión para un espacio de nombres o un centro de eventos específico mediante Azure Portal, PowerShell o la CLI.

Portal de Azure

Cadena de conexión para un espacio de nombres

  1. Inicie sesión en el portal de Azure.

  2. Seleccione Todos los servicios en el menú de navegación izquierdo.

  3. Seleccione Event Hubs en la sección Analytics.

  4. En la lista de centros de eventos, seleccione el centro de eventos.

  5. En la página Espacio de nombres de Event Hubs, seleccione Directivas de acceso compartido en el menú de la izquierda.

  6. Seleccione una directiva de acceso compartido en la lista de directivas. El valor predeterminado es: RootManageSharedAccessPolicy. Puede agregar una directiva con los permisos adecuados (lectura y escritura) y usar esa directiva.

    Directivas de acceso compartido de Event Hubs

  7. Seleccione el botón Copiar junto al campo Cadena de conexión: clave principal.

    Obtención de la cadena de conexión de Event Hubs

Cadena de conexión para un centro de eventos específico en un espacio de nombres

En esta sección se indican los pasos para obtener una cadena de conexión para un centro de eventos específico en un espacio de nombres.

  1. En la página Espacio de nombres de Event Hubs, seleccione el centro de eventos en el panel inferior.

  2. En la página Instancia de Event Hubs, seleccione Directivas de acceso compartido en el menú de la izquierda.

  3. No hay ninguna directiva predeterminada que se haya creado para un centro de eventos. Cree una directiva con el acceso Administrar, Enviar o Escuchar.

  4. Seleccione la directiva de la lista.

  5. Seleccione el botón Copiar junto al campo Cadena de conexión: clave principal.

    Cadena de conexión a un centro de eventos específico

Azure PowerShell

Puede usar Get-AzEventHubKey para obtener la cadena de conexión del nombre de directiva o regla específica.

Este es un comando de ejemplo para obtener la cadena de conexión de un espacio de nombres. MyAuthRuleName es el nombre de la directiva de acceso compartido. En cuanto al espacio de nombres, tiene uno predeterminado: RootManageSharedAccessKey.

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

Este es un comando de ejemplo para obtener la cadena de conexión de un centro de eventos específico que esté en un espacio de nombres:

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

Este es un comando de ejemplo para obtener la cadena de conexión de un centro de eventos en un clúster de Geo-DR, que tiene un alias.

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

Azure CLI

Este es un comando de ejemplo para obtener la cadena de conexión de un espacio de nombres. MyAuthRuleName es el nombre de la directiva de acceso compartido. En cuanto al espacio de nombres, tiene uno predeterminado: RootManageSharedAccessKey.

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

Este es un comando de ejemplo para obtener la cadena de conexión de un centro de eventos específico que esté en un espacio de nombres:

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

Este es un comando de ejemplo para obtener la cadena de conexión de un centro de eventos en un clúster de Geo-DR, que tiene un alias.

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

Para más información sobre los comandos de la CLI de Azure para Event Hubs, consulte CLI de Azure para Event Hubs.

Pasos siguientes

Para más información acerca de Event Hubs, visite los vínculos siguientes: