Obter uma cadeia de ligação do Hubs de Eventos do Azure

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 utilizar uma cadeia de ligação ao espaço de nomes na sua aplicação, a aplicação terá o acesso concedido (gerir, ler ou escrever) a todos os centros de eventos no espaço de nomes. Se utilizar uma cadeia de ligação ao event hub, terá o acesso concedido a esse event hub específico.

A cadeia de ligação para um namespace tem os seguintes componentes incorporados:

• 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 ligação para um event hub tem um componente extra, ou seja, 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.

Pré-requisitos

• Uma assinatura do Azure. Se não tiver uma, crie uma conta gratuita antes de começar.
• Um espaço de nomes do Event Hubs e um concentrador de eventos. Se não os tiver, veja Quickstart: Criar um hub de eventos usando o portal Azure.
• Para usar o Azure PowerShell ou o CLI do Azure, use o Azure Cloud Shell, ou instale o Azure PowerShell ou o CLI do Azure localmente.

portal do Azure

Cadeia de conexão para um namespace

1. Inicie sessão no portal Azure.

2. Na caixa de pesquisa no topo do portal, introduza Event Hubs e depois selecione Event Hubs nos resultados.

3. Na lista de namespaces do Event Hubs, selecione o seu namespace.

4. Na página do namespace dos Centros de Eventos , selecione Políticas de acesso partilhado no menu esquerdo em Definições.

5. Selecione uma política de acesso partilhado na lista de políticas. A política padrão chama-se RootManageSharedAccessKey. Também pode adicionar uma política com as permissões apropriadas (Enviar, Ouvir) e usar essa política.

6. Selecione o botão Copiar ao lado do campo Cadeia de ligação – chave primária.

   

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 do namespace dos Centros de Eventos , selecione Centros de Eventos em Entidades no menu esquerdo e depois selecione o seu hub de eventos.

2. Na página da instância do Event Hubs, selecione Políticas de acesso partilhado no menu à esquerda, em Definições.

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

4. Selecione a política na lista.

5. Selecione o botão Copiar ao lado do campo Cadeia de ligação - chave primária.

   

Azure PowerShell

Use o cmdlet Get-AzEventHubKey para obter a cadeia de ligação de uma política ou regra específica.

O exemplo seguinte obtém a cadeia de ligação para um namespace. MyAuthRuleName é o nome da política de acesso compartilhado. Para um namespace, a política padrão é RootManageSharedAccessKey.

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

O exemplo seguinte obtém a cadeia de ligação para um hub de eventos específico dentro de um namespace:

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

O exemplo seguinte obtém a cadeia de ligação de um espaço de nomes que faz parte de uma configuração de recuperação após desastre geográfico, através do respetivo alias.

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

CLI do Azure

O exemplo seguinte obtém a cadeia de ligação de um espaço de nomes. MyAuthRuleName é o nome da política de acesso compartilhado. Para um namespace, a política padrão é RootManageSharedAccessKey.

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

O exemplo seguinte obtém a cadeia de ligaçã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

O exemplo seguinte obtém a cadeia de ligação de um namespace que faz parte de uma configuração de recuperação após desastre geográfico, utilizando o respetivo alias.

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

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

Conteúdos relacionados

Pode saber mais sobre os Event Hubs visitando os seguintes artigos:

• Descrição geral dos Hubs de Eventos
• Criar um hub de eventos