Obter uma cadeia de conexão do Hubs de Eventos do Azure

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 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 conexão com o hub de eventos, terá o acesso fornecido a esse hub de eventos específico.

A cadeia de conexão de um namespace possui os seguintes componentes embutidos 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 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, PowerShell ou CLI.

Pré-requisitos

• Uma assinatura do Azure. Se você não tiver uma conta gratuita, crie uma antes de começar.
• Um namespace dos Hubs de Eventos e um hub de eventos. Se você não tiver, veja Início Rápido: Criar um hub de eventos usando o portal do Azure.
• Para usar Azure PowerShell ou a CLI do Azure, use o Azure Cloud Shell, ou instale o Azure PowerShell ou o CLI do Azure localmente.

portal do Azure

Cadeia de caracteres de conexão para um namespace

1. Entre no portal do Azure.

2. Na caixa de pesquisa na parte superior do portal, digite Event Hubs e, em seguida, selecione Event Hubs nos resultados.

3. Na lista de namespaces dos Hubs de Eventos, selecione seu namespace.

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

5. Selecione uma política de acesso compartilhado na lista de políticas. A política padrão é chamada RootManageSharedAccessKey. Você 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 Chave primária da 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 do namespace Event Hubs , selecione Event Hubs em Entidades no menu esquerdo e depois selecione seu hub de eventos.

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

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.

   

Azure PowerShell

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

O exemplo a seguir obtém a cadeia de conexã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 a seguir obtém 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

O exemplo a seguir obtém a cadeia de conexão de um namespace que faz parte de uma configuração de recuperação de desastres geográficos, usando seu alias.

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

CLI do Azure

O exemplo a seguir obtém a cadeia de conexão para um namespace. 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 a seguir obtém 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

O exemplo a seguir obtém a cadeia de conexão de um namespace que faz parte de uma configuração de recuperação de desastres geográficos, usando seu 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 Hubs de Eventos, consulte CLI do Azure para Hubs de Eventos.

Conteúdo relacionado

Você pode saber mais sobre os Event Hubs visitando os seguintes artigos:

• Visão geral de Hubs de Eventos
• Criar um hub de eventos