Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
- Uma conta do Azure com uma assinatura ativa. Cria uma conta gratuitamente.
- Um espaço de nomes do Event Grid. Para criar um, consulte Criar, visualizar e gerir namespaces.
- Um tópico de espaço de nomes no seu espaço de nomes do Event Grid. Para criar um, consulte Criar, visualizar e gerir tópicos de namespace.
Crie uma subscrição de evento num tópico de namespace
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.
Na secção Entidades , selecione Subscrições.
Na página de Subscrições , selecione + Subscrição.
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:
A captura de ecrã seguinte mostra as definições para uma subscrição de entrega push:
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.
No separador Funcionalidades Adicionais , defina a duração do bloqueio em minutos, especifique a contagem máxima de entregas e depois selecione Criar.
Ver uma subscrição de evento num tópico de espaço de nomes
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.
Na secção Entidades , selecione Subscrições.
Procura a subscrição que queres ver e depois seleciona-a.
Reveja as definições da subscrição de eventos.
Eliminar uma subscrição de eventos num tópico de namespace
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.
Na secção Entidades , selecione Subscrições.
Procura a subscrição que queres eliminar e depois seleciona-a.
Na página Visão geral, selecione Excluir na barra de ferramentas.
Na página de confirmação, introduza o nome do recurso e depois selecione Eliminar para confirmar a eliminação.
Configurar filtros para uma subscrição de um tópico de espaço de nomes
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.
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 |