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

Um tópico personalizado de Grade de Eventos oferece um endpoint definido pelo usuário onde você publica seus próprios eventos de aplicação. Um domínio permite gerenciar muitos tópicos relacionados como um único recurso, o que ajuda quando você envia eventos para muitos assinantes em uma grande organização.

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

Pré-requisitos

Se você é novo no Grade de Eventos do Azure, leia a visão geral do Event Grid antes de começar.

Registrar o provedor de recursos do Event Grid

A menos que você tenha usado a Grade de Eventos antes, será necessário registrar o provedor de recursos da Grade de Eventos. Se você usou a Grade de Eventos antes, pule para a próxima seção.

No portal do Azure, siga estas etapas:

  1. No menu à esquerda, selecione Assinaturas.

  2. Selecione a assinatura que você deseja usar para a Grade de Eventos na lista de assinaturas.

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

  4. Pesquise por Microsoft.EventGrid e confirme que o Status é Não registrado.

  5. Selecione Microsoft.EventGrid na lista de provedores.

  6. Na barra de comandos, selecione Registrar.

    Captura de tela que mostra o registro do provedor Microsoft.EventGrid em uma assinatura do Azure.

  7. Atualize para garantir que o status de Microsoft.EventGrid foi alterado para Registrado.

    Captura de tela que mostra o registro bem-sucedido do provedor Microsoft.EventGrid em uma assinatura do Azure.

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. Entre 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, pesquise domínios da Grade de Eventos.

    Captura de tela mostrando a barra de busca do portal do Azure para buscar tópicos do Event Grid.

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

    Captura de tela mostrando o botão Criar Tópico na página de tópicos do Grid de Eventos.

Página de Noções Básicas

Na página Noções básicas do assistente Criar Tópico ou assistente Criar Domínio da Grade de Eventos, siga estas etapas:

  1. Selecione sua assinatura do Azure.

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

  3. Insira um nome único para o tema ou domínio personalizado. O nome deve ser único porque uma entrada do Sistema de Nomes de Domínio (DNS) o representa. Não use o nome mostrado na imagem. Em vez disso, crie seu próprio nome. Deve ter entre 3 e 50 caracteres e conter apenas os valores a-z, A-Z, 0-9 e "-".

  4. Selecione uma região para o tópico ou domínio da Grade de Eventos.

  5. Selecione Avançar: Rede na parte inferior da página para alternar para a página Rede .

    Captura de tela mostrando a página de Fundamentos do assistente de Criar Tópico.

Página de rede

Na página Redes do Assistente para Criar Tópico ou Criar Domínio da Grade de Eventos, siga estas etapas:

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

    Captura de tela mostrando a seleção da opção de acesso público na página Rede do assistente Criar tópico.

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

    Captura de tela mostrando a seleção da opção de acesso privado na página Rede do assistente Criar tópico.

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

  4. Selecione Avançar: Segurança na parte inferior da página para alternar para a página Segurança .

Página de segurança

Na página Segurança do Assistente para Criar Tópico ou Criar Domínio da Grade de Eventos, siga estas etapas:

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

    Captura de tela da página Identidade com a opção de identidade atribuída pelo sistema selecionada.

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

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

    Captura de tela da página Identidade com a opção de identidade atribuída pelo usuário selecionada.

  4. Para desabilitar a autenticação local, selecione Desabilitado. Quando você desativa a autenticação local, o tópico ou domínio aceita apenas autenticação Microsoft Entra, não chave de acesso ou autenticação SAS.

    Captura de tela mostrando a guia Avançado da página Criar Tópico, em que você pode desabilitar a autenticação local.

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

    Captura de tela mostrando a guia Avançado da página Criar Tópico quando você pode selecionar a versão mínima do TLS.

  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çada do assistente Criar Tópico ou Criar Domínio de Grade de Eventos , selecione o esquema para eventos que você publica neste tópico.

    Captura de tela mostrando a seleção de um esquema na página Avançado.

  2. Para residência de dados, selecione se deseja manter todos os dados na mesma região (Regional) ou replicar os metadados para uma região secundária pré-definida (Cross-Geo).

    Captura de tela mostrando a seção Residência de dados da página Avançado no assistente Criar Tópico.

    A opção Trans-geográfico permite o failover iniciado pela Microsoft para a região emparelhada quando há falha de região. Para obter mais informações, consulte recuperação de desastres geográfica do lado do servidor no Grade de Eventos do Azure. A Microsoft executa o failover iniciado pela própria Microsoft em situações raras para fazer o failover dos recursos do Event Grid de uma região afetada para a região emparelhada geograficamente correspondente. Esse processo não exige sua intervenção. A Microsoft reserva-se o direito de decidir quando seguir esse caminho. O mecanismo não exige seu consentimento antes de fazer o failover do seu tópico ou domínio. Para mais informações, consulte Como me recuperar após um failover?

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

  3. Selecione Avançar: Tags para ir para a página Tags.

Página de tags

A página de Tags não possui campos específicos para a Grade de Eventos. Você pode atribuir uma tag (par nome-valor), assim como faz com qualquer outro recurso do Azure. Selecione Avançar: Examinar + criar para alternar para a página Examinar + criar .

Revisar + criar página

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

Captura de tela mostrando a página Revisar + criar.

Próximas Etapas 

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:

Para aprender sobre como publicar eventos e consumir eventos do Event Grid usando diferentes linguagens de programação, veja os exemplos a seguir: