Partilhar via

Obter uma cadeia de conexão de Hubs de Eventos

  • Artigo

Para se comunicar com um hub de eventos em um namespace, você precisa de uma cadeia de conexão para o namespace ou o hub de eventos. Se você usar uma cadeia de conexão para o namespace do seu 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 conexão para o hub de eventos, terá o acesso fornecido a esse hub de eventos específico.

A cadeia de conexão para um namespace tem os seguintes componentes incorporados nele,

  • Nome de domínio totalmente qualificado do namespace Hubs de Eventos que você criou (inclui o nome do namespace Hubs de Eventos seguido de servicebus.windows.net)
  • Nome da chave de acesso partilhada
  • Valor da chave de acesso partilhada

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

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

A cadeia de conexão para um hub de eventos tem um componente adicional. 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, o PowerShell ou a CLI.

Portal do Azure

Cadeia de conexão para um namespace

  1. Inicie sessão no portal do Azure.

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

  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 Hubs de Eventos, selecione Políticas de Acesso Compartilhado no menu à esquerda em Configurações.

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

  7. Selecione o botão de cópia ao lado do campo Cadeia de conexão-chave primária.

    Captura de ecrã de Hubs de Eventos - obter cadeia de ligaçã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 conexão para um hub de eventos específico em um namespace.

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

  2. Na página de instância de Hubs de Eventos, selecione Políticas de acesso compartilhado no menu esquerdo em Configurações.

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

  4. Selecione a política na lista.

  5. Selecione o botão de cópia ao lado do campo Cadeia de conexão-chave primária.

    Captura de tela da cadeia de conexão para um hub de eventos específico.

Azure PowerShell

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

Aqui está um comando de exemplo para obter a cadeia de conexão para 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 para um hub de eventos específico dentro de 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 para 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 conexão para 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 para um hub de eventos específico dentro de 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 para 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 comandos da CLI do Azure para Hubs de Eventos, consulte CLI do Azure para Hubs de Eventos.

Conteúdos relacionados

Pode saber mais sobre os Hubs de Eventos ao aceder às seguintes ligações: