Obter uma cadeia de conexão dos Hubs de Eventos

  • Artigo

Para se comunicar com um hub de eventos em um namespace, você precisa de uma cadeia de caracteres de conexão para o namespace ou o hub de eventos. Se você usar uma cadeia de caracteres de conexão com o namespace do aplicativo, o aplicativo terá o acesso fornecido (gerenciar, ler ou gravar) a todos os hubs de eventos no namespace. Se você usar uma cadeia de caracteres de conexão com o hub de eventos, terá o acesso fornecido a esse hub de eventos específico.

A cadeia de conexão para os namespace tem os seguintes componentes inseridos nela

  • O nome de domínio totalmente qualificado do namespace dos Hubs de Eventos que você criou (inclui o nome do namespace dos Hubs de Eventos seguido por servicebus.windows.net)
  • O nome da chave de acesso compartilhada
  • O valor da chave de acesso compartilhada

A cadeia de conexão de um namespace tem a aparência:

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

A cadeia de conexão de um hub de eventos tem um componente adicional nele. Isso é, EntityPath=<EventHubName>.

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

Este artigo mostra como obter uma cadeia de conexão para um namespace ou um hub de eventos específico usando o portal do Azure, PowerShell ou CLI.

Portal do Azure

Cadeia de caracteres de conexão para um namespace

  1. Entre no Portal do Azure.

  2. Selecione Todos os serviços no menu esquerdo de navegação.

  3. Selecione Hubs de Eventos na seção Análise.

  4. Na lista de hubs de eventos, selecione seu hub de eventos.

  5. Na página Namespace de Hubs de Eventos, selecione Políticas de Acesso Compartilhado no menu à esquerda.

  6. Selecione uma política de acesso compartilhado na lista de políticas. O padrão é chamado: RootManageSharedAccessPolicy. Você pode adicionar uma política com permissões apropriadas (enviar, escutar) e usar essa política.

    Políticas de acesso compartilhado de hubs de eventos

  7. Selecione o botão Copiar ao lado do campo Chave primária da cadeia de conexão.

    Hubs de Eventos - obter a cadeia de conexão

Cadeia de conexão para um hub de eventos específico em um namespace

Esta seção fornece etapas para obter uma cadeia de caracteres de conexão para um hub de eventos específico em um namespace.

  1. Na página Namespace de Hubs de Eventos, selecione o hub de eventos no painel inferior.

  2. Na página da instância de Hubs de Eventos, selecione Políticas de acesso compartilhado no menu à esquerda.

  3. Não há nenhuma política padrão criada para um hub de eventos. Crie uma política com acesso de Gerenciamento, Envio ou Escuta.

  4. Selecione a política na lista.

  5. Selecione o botão Copiar ao lado do campo Chave primária da cadeia de conexão.

    Cadeia de conexão com um hub de eventos específico.

Azure PowerShell

Você pode usar Get-AzEventHubKey para obter a cadeia de conexão do nome de política/regra específico.

Aqui está um comando de exemplo para obter a cadeia de caracteres de conexão de um namespace. MyAuthRuleName é o nome da política de acesso compartilhado. Para um namespace, há um padrão: RootManageSharedAccessKey.

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

Aqui está um comando de exemplo para obter a cadeia de conexão de um hub de eventos específico em um namespace:

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

Aqui está um comando de exemplo para obter a cadeia de conexão de um hub de eventos em um cluster Geo-DR, que tem um alias.

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

CLI do Azure

Aqui está um comando de exemplo para obter a cadeia de caracteres de conexão de um namespace. MyAuthRuleName é o nome da política de acesso compartilhado. Para um namespace, há um padrão: RootManageSharedAccessKey.

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

Aqui está um comando de exemplo para obter a cadeia de conexão de um hub de eventos específico em um namespace:

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

Aqui está um comando de exemplo para obter a cadeia de conexão de um hub de eventos em um cluster Geo-DR, que tem um alias.

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

Para obter mais informações sobre os comandos da CLI do Azure para Hubs de Eventos, consulte CLI do Azure para Hubs de Eventos.

Próximas etapas

Você pode saber mais sobre Hubs de Eventos visitando os links abaixo: