Partilhar via

Criar um tópico personalizado ou um domínio na Grade de Eventos do Azure

  • Artigo

Este artigo mostra como criar um tópico personalizado ou um domínio na Grade de Eventos do Azure.

Pré-requisitos

Se você é novo na Grade de Eventos do Azure, leia a visão geral da Grade de Eventos antes de iniciar este tutorial.

Registrar o provedor de recursos da Grade de Eventos

A menos que você já tenha usado a Grade de Eventos antes, precisará registrar o provedor de recursos da Grade de Eventos. Se já utilizou a Grelha de Eventos antes, avance para a secção seguinte.

No portal do Azure, execute as seguintes etapas:

  1. No menu à esquerda, selecione Assinaturas.

  2. Selecione a subscrição que pretende utilizar para a Grelha de Eventos na lista de subscrições.

  3. Na página Assinatura, selecione Provedores de recursos em Configurações no menu à esquerda.

  4. Procure Microsoft.EventGrid e confirme se o Status não está registrado.

  5. Selecione Microsoft.EventGrid na lista de provedores.

  6. Selecione Registrar na barra de comandos.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Atualize para verificar se o status de Microsoft.EventGrid foi alterado para Registrado.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Criar um tópico ou domínio personalizado

Um tópico de Grade de Eventos fornece um ponto de extremidade definido pelo usuário no qual você posta seus eventos.

  1. Inicie sessão no portal do Azure.

  2. Na barra de pesquisa na parte superior, digite Tópicos da Grade de Eventos e selecione Tópicos da Grade de Eventos na lista suspensa. Para criar um domínio, procure Domínios da Grade de Eventos.

    Screenshot showing the Azure port search bar to search for Event Grid topics.

  3. Na página Tópicos da Grade de Eventos ou Domínios da Grade de Eventos, selecione + Criar na barra de ferramentas.

    Screenshot showing the Create Topic button on Event Grid topics page.

Página Noções básicas

Na página Noções básicas do assistente Criar tópico ou Criar domínio de grade de eventos, siga estas etapas:

  1. Selecione a sua subscrição do Azure.

  2. Selecione um grupo de recursos existente ou selecione Criar novo e insira um nome para o grupo de recursos.

  3. Forneça um nome exclusivo para o tópico ou domínio personalizado. O nome deve ser exclusivo porque é representado por uma entrada DNS (Sistema de Nomes de Domínio). Não utilize o nome apresentado na imagem. Em vez disso, crie seu próprio nome - ele deve ter entre 3-50 caracteres e conter apenas os valores a-z, A-Z, 0-9 e "-".

  4. Selecione um local para o tópico ou domínio da Grade de Eventos.

  5. Selecione Next: Networking na parte inferior da página para alternar para a página Networking .

    Screenshot showing the Networking page of the Create Topic wizard.

Página de rede

Na página Rede do assistente Criar Tópico ou Criar Domínio de Grade de Eventos, siga estas etapas:

  1. Se você quiser permitir que os clientes se conectem ao tópico ou ao ponto de extremidade do domínio por meio de um endereço IP público, mantenha a opção Acesso público selecionada. Você pode restringir o acesso a endereços IP específicos ou intervalo de endereços IP.

    Screenshot showing the selection of Public access option on the Networking page of the Create topic wizard.

  2. Para permitir o acesso ao tópico ou domínio por meio de um ponto de extremidade privado, selecione a opção Acesso privado .

    Screenshot showing the selection of Private access option on the Networking page of the Create topic wizard.

  3. Siga as instruções na seção Adicionar um ponto de extremidade privado usando o portal do Azure para criar um ponto de extremidade privado.

  4. Selecione Seguinte: Segurança na parte inferior da página para mudar para a página Segurança.

Página de segurança

Na página Segurança do assistente Criar Tópico ou Criar Domínio de Grelha de Eventos, siga estes passos:

  1. Para atribuir uma identidade gerenciada atribuída pelo sistema ao seu tópico ou domínio, selecione Habilitar identidade atribuída ao sistema.

    Screenshot of the Identity page with system assigned identity option selected.

  2. Para atribuir uma identidade atribuída pelo usuário, selecione Adicionar identidade atribuída ao usuário na seção Identidade atribuída ao usuário da página.

  3. Na janela Selecionar identidade atribuída ao usuário, selecione a assinatura que tem a identidade atribuída pelo usuário, selecione a identidade atribuída pelo usuário e clique em Selecionar.

    Screenshot of the Identity page with user assigned identity option selected.

  4. Para desativar a autenticação local, selecione Desativado. Quando você faz isso, o tópico ou domínio não pode ser acessado usando chave de acesso e autenticação SAS, mas apenas por meio da autenticação Microsoft Entra.

    Screenshot showing the Advanced tab of Create Topic page when you can disable local authentication.

  5. Configure a versão mínima necessária do Transport Layer Security (TLS). Para obter mais informações, consulte Configurar a versão mínima do TLS.

    Screenshot showing the Advanced tab of Create Topic page when you can select the minimum TLS version.

  6. Selecione Avançado na parte inferior da página para alternar para a página Avançado.

Página avançada

  1. Na página Avançado do assistente Criar Tópico ou Criar Domínio de Grade de Eventos, selecione o esquema para eventos que serão publicados neste tópico.

    Screenshot showing the selection of a schema on the Advanced page.

  2. Em Residência de dados, selecione se não deseja que nenhum dado seja replicado para outra região (Regional) ou se deseja que os metadados sejam replicados para uma região secundária predefinida (Cross-Geo).

    Screenshot showing the Data residency section of the Advanced page in the Create Topic wizard.

    A opção Cross-Geo permite failover iniciado pela Microsoft para a região emparelhada quando há uma falha de região. Para obter mais informações, consulte Recuperação de desastres geográficos do lado do servidor na Grade de Eventos do Azure. O failover iniciado pela Microsoft é exercido pela Microsoft em situações raras para fazer failover de recursos da Grade de Eventos de uma região afetada para a região emparelhada geograficamente correspondente. Este processo não requer uma intervenção do utilizador. A Microsoft reserva-se o direito de determinar quando este caminho será tomado. O mecanismo não envolve um consentimento do usuário antes que o tópico ou domínio do usuário seja submetido a failover. Para obter mais informações, consulte Como me recuperar de um failover?.

    Se você selecionar a opção Regional , poderá definir seu próprio plano de recuperação de desastres.

  3. Selecione Next: Tags para ir para a página Tags.

Página de tags

A página Tags não tem campos específicos para a Grade de Eventos. Você pode atribuir uma marca (par nome-valor) como faz para qualquer outro recurso do Azure. Selecione Seguinte: Rever + criar para mudar para a página Rever + criar.

Rever + criar página

Na página Rever + criar, reveja todas as definições, confirme se a validação foi bem-sucedida e, em seguida, selecione Criar para criar o tópico ou o domínio.

Screenshot showing the Review + create page.

Próximos passos

Agora que você sabe como criar tópicos ou domínios personalizados, saiba mais sobre o que a Grade de Eventos pode ajudá-lo a fazer:

Consulte os exemplos a seguir para saber mais sobre como publicar e consumir eventos da Grade de Eventos usando diferentes linguagens de programação.