Criar, visualizar e gerir subscrições de eventos em tópicos de namespace

Uma subscrição de evento define como um consumidor recebe eventos publicados num tópico de namespace. Este artigo mostra-lhe como criar, visualizar e gerir subscrições de eventos para tópicos de namespace no Azure Event Grid utilizando o portal Azure.

Quando crias uma subscrição de eventos, escolhes entre a entrega em pull ou em push. Com a entrega por solicitação, a sua aplicação liga-se ao Event Grid para ler os eventos ao seu próprio ritmo. Com a entrega push, o Event Grid envia eventos para um destino que configura. Para saber mais sobre estas opções, consulte a descrição geral do modelo pull e a descrição geral do modelo push.

Pré-requisitos

Crie uma subscrição de evento num tópico de namespace

  1. No portal do Azure, vai ao tópico do namespace que queres usar para a subscrição do evento. Para os passos para localizar um tema, consulte Criar, visualizar e gerir tópicos de namespace.

  2. Na secção Entidades , selecione Subscrições.

    Captura de ecrã a mostrar subscrições de eventos do Event Grid.

  3. Na página de Subscrições , selecione + Subscrição.

    Captura de ecrã que mostra a criação de subscrição de evento do Event Grid.

  4. No separador Básicos, introduza um nome para a subscrição de eventos e, em seguida, selecione o modo de entrega.

    Importante

    Ao criar uma subscrição, escolha entre o modo de entrega Pull ou Push . Para saber mais sobre os modos de consumo disponíveis nos namespaces Event Grid, consulte a visão geral da entrega Pull ou a visão geral da entrega Push.

    A captura de ecrã seguinte mostra as definições para uma subscrição de pull delivery:

    Captura de ecrã a mostrar a criação de subscrição de evento pull.

    A captura de ecrã seguinte mostra as definições para uma subscrição de entrega push:

    Captura de ecrã a mostrar a criação de subscrição do evento push.

  5. No separador Filtros, adicione os tipos de evento pelos quais pretende filtrar e adicione quaisquer filtros de atributos de contexto que pretenda utilizar na subscrição.

    Captura de ecrã que mostra os filtros de criação da subscrição de eventos do Event Grid.

  6. No separador Funcionalidades Adicionais , defina a duração do bloqueio em minutos, especifique a contagem máxima de entregas e depois selecione Criar.

    Captura de ecrã a mostrar a subscrição de eventos da Grelha de Eventos para criar funcionalidades adicionais.

Ver uma subscrição de evento num tópico de espaço de nomes

  1. Vai ao tópico do namespace que contém a subscrição do evento que queres ver. Para os passos para localizar um tema, consulte Criar, visualizar e gerir tópicos de namespace.

  2. Na secção Entidades , selecione Subscrições.

    Captura de ecrã a mostrar subscrições de eventos do Event Grid.

  3. Procura a subscrição que queres ver e depois seleciona-a.

    Captura de ecrã que mostra a pesquisa de subscrições de eventos do Event Grid.

  4. Reveja as definições da subscrição de eventos.

    Captura de ecrã que mostra a subscrição do evento Event Grid.

Eliminar uma subscrição de eventos num tópico de namespace

  1. Vai ao tópico do namespace que contém a subscrição do evento que queres apagar. Para os passos para localizar um tema, consulte Criar, visualizar e gerir tópicos de namespace.

  2. Na secção Entidades , selecione Subscrições.

    Captura de ecrã a mostrar subscrições de eventos do Event Grid.

  3. Procura a subscrição que queres eliminar e depois seleciona-a.

    Captura de ecrã que mostra a pesquisa de subscrições de eventos do Event Grid.

  4. Na página Visão geral, selecione Excluir na barra de ferramentas.

    Captura de ecrã que mostra a eliminação da subscrição do evento do Event Grid.

  5. Na página de confirmação, introduza o nome do recurso e depois selecione Eliminar para confirmar a eliminação.

    Captura de ecrã que mostra a confirmação da exclusão da subscrição do evento do Event Grid.

Configurar filtros para uma subscrição de um tópico de espaço de nomes

  1. Para atualizar os filtros de uma subscrição existente, vá à subscrição e depois selecione Filtros na secção de Definições . Adiciona os tipos de eventos que queres filtrar, adiciona quaisquer filtros de atributos de contexto que queiras usar e depois seleciona Guardar.

    Captura de ecrã das definições dos filtros da subscrição de eventos do Event Grid.

Modelo de filtragem simplificado para subscrições de tópicos do namespace

As subscrições de eventos num tópico de espaço de nomes têm um modelo de configuração de filtragem simplificado, em comparação com as subscrições de eventos para domínios e para tópicos personalizados, de sistema, de parceiros e de domínio. As capacidades de filtragem são as mesmas, exceto pela forma como configuras os filtros no subject atributo. As secções seguintes explicam as diferenças.

Filtrar nos dados do evento

Pode filtrar eventos com base nos valores do objeto de evento data quando os dados do evento são um objeto JSON. Para mais informações, consulte Subscrições do Evento.

O assunto começa com

Nenhuma propriedade de configuração dedicada especifica filtros em subject. Para filtrar o atributo subject de contexto com um valor que começa com uma string, use a seguinte configuração de filtro.

Valor-chave operador value
subject A cadeia de caracteres começa por a tua cadeia de caracteres

O tema termina com

Nenhuma propriedade de configuração dedicada especifica filtros em subject. Para filtrar o atributo subject de contexto com um valor que termina numa cadeia, use a seguinte configuração de filtro.

Valor-chave operador value
subject A cadeia de caracteres termina em a sua cadeia de caracteres