Obter uma cadeia de ligação dos Hubs de Eventos

  • Artigo

Para comunicar com um hub de eventos num espaço de nomes, precisa de uma cadeia de ligação para o espaço de nomes ou o hub de eventos. Se utilizar uma cadeia de ligação para o espaço de nomes da sua aplicação, a aplicação terá o acesso fornecido (gerir, ler ou escrever) a todos os hubs de eventos no espaço de nomes. Se utilizar uma cadeia de ligação para o hub de eventos, terá o acesso fornecido a esse hub de eventos específico.

A cadeia de ligação de um espaço de nomes tem os seguintes componentes incorporados no mesmo,

  • Nome de domínio completamente qualificado do espaço de nomes dos Hubs de Eventos que criou (inclui o nome do espaço de nomes dos Hubs de Eventos seguido de servicebus.windows.net)
  • Nome da chave de acesso partilhado
  • Valor da chave de acesso partilhado

A cadeia de ligação de um espaço de nomes tem o seguinte aspeto:

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

A cadeia de ligação de um hub de eventos tem um componente adicional. Isto é, EntityPath=<EventHubName>.

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

Este artigo mostra-lhe como obter uma cadeia de ligação para um espaço de nomes ou um hub de eventos específico com a portal do Azure, o PowerShell ou a CLI.

Portal do Azure

Cadeia de ligação para um espaço de nomes

  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 secção Análise .

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

  5. Na página Espaço de Nomes dos Hubs de Eventos , selecione Políticas de Acesso Partilhado no menu esquerdo.

  6. Selecione uma política de acesso partilhado na lista de políticas. A predefinição é denominada: RootManageSharedAccessPolicy. Pode adicionar uma política com as permissões adequadas (enviar, escutar) e utilizar essa política.

    Políticas de acesso partilhado dos Hubs de Eventos

  7. Selecione o botão copiar junto ao campo Chave primária da cadeia de ligação .

    Hubs de Eventos – obter a cadeia de ligação

Cadeia de ligação para um hub de eventos específico num espaço de nomes

Esta secção dá-lhe os passos para obter uma cadeia de ligação para um hub de eventos específico num espaço de nomes.

  1. Na página Espaço de Nomes dos Hubs de Eventos , selecione o hub de eventos no painel inferior.

  2. Na página instância dos Hubs de Eventos , selecione Políticas de acesso partilhado no menu esquerdo.

  3. Não existe nenhuma política predefinida criada para um hub de eventos. Crie uma política com o acesso Gerir, Enviar ou Escutar .

  4. Selecione a política na lista.

  5. Selecione o botão copiar junto ao campo Chave primária da cadeia de ligação .

    Cadeia de ligação a um hub de eventos específico.

Azure PowerShell

Pode utilizar Get-AzEventHubKey para obter a cadeia de ligação para a política/regra específica.

Eis um comando de exemplo para obter a cadeia de ligação de um espaço de nomes. MyAuthRuleName é o nome da política de acesso partilhado. Para um espaço de nomes, existe um predefinido: RootManageSharedAccessKey.

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

Eis um comando de exemplo para obter a cadeia de ligação de um hub de eventos específico num espaço de nomes:

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

Segue-se um comando de exemplo para obter a cadeia de ligação de um hub de eventos num cluster Geo-DR, que tem um alias.

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

CLI do Azure

Eis um comando de exemplo para obter a cadeia de ligação de um espaço de nomes. MyAuthRuleName é o nome da política de acesso partilhado. Para um espaço de nomes, existe um predefinido: RootManageSharedAccessKey

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

Eis um comando de exemplo para obter a cadeia de ligação de um hub de eventos específico num espaço de nomes:

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

Segue-se um comando de exemplo para obter a cadeia de ligação de um hub de eventos num 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, veja CLI do Azure para Hubs de Eventos.

Passos seguintes

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