Esquema de subscrição do Event Grid

Artigo
06/01/2023

Para criar uma subscrição do Event Grid, envie um pedido para a operação Criar subscrição de Eventos. Utilize o seguinte formato:

PUT /subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/{resource-provider}/{resource-type}/{resource-name}/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01

Por exemplo, para criar uma subscrição de evento para uma conta de armazenamento com o nome examplestorage num grupo de recursos com o nome examplegroup, utilize o seguinte formato:

PUT /subscriptions/{subscription-id}/resourceGroups/examplegroup/providers/Microsoft.Storage/storageaccounts/examplestorage/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01

O nome da Subscrição de Eventos tem de ter entre 3 e 64 carateres e só pode conter a-z, A-Z, 0-9 e "-". O artigo descreve as propriedades e o esquema do corpo do pedido.

Propriedades da subscrição de eventos

Propriedade	Tipo	Descrição
destino	objeto	O objeto que define o ponto final.
filter	objeto	Um campo opcional para filtrar os tipos de eventos.

objeto de destino

Propriedade	Tipo	Descrição
endpointType	string	O tipo de ponto final para a subscrição (webhook/HTTP, Hub de Eventos ou fila).
endpointUrl	string	O URL de destino para eventos nesta subscrição de evento.

filtrar objeto

Propriedade	Tipo	Descrição
includedEventTypes	matriz	Corresponder quando o tipo de evento na mensagem de evento é uma correspondência exata com um destes nomes de tipo de evento. Gera um erro quando o nome do evento não corresponde aos nomes do tipo de evento registados para a origem do evento. A predefinição corresponde a todos os tipos de eventos.
subjectBeginsWith	string	Um filtro prefix-match para o campo assunto na mensagem de evento. A cadeia predefinida ou vazia corresponde a todas.
subjectEndsWith	string	Um filtro de correspondência de sufixos para o campo assunto na mensagem de evento. A cadeia predefinida ou vazia corresponde a todas.
isSubjectCaseSensitive	string	Controla a correspondência sensível a maiúsculas e minúsculas para filtros.
enableAdvancedFilteringOnArrays	boolean	Ativa a utilização de matrizes para chaves na filtragem avançada. Para obter mais informações, veja Filtragem avançada.

Esquema de subscrição de exemplo

{
  "properties": {
    "destination": {
      "endpointType": "webhook",
      "properties": {
          "endpointUrl": "https://example.azurewebsites.net/api/HttpTriggerCSharp1?code=VXbGWce53l48Mt8wuotr0GPmyJ/nDT4hgdFj9DpBiRt38qqnnm5OFg=="
      }
    },
    "filter": {
      "includedEventTypes": [ "Microsoft.Storage.BlobCreated", "Microsoft.Storage.BlobDeleted" ],
      "subjectBeginsWith": "/blobServices/default/containers/mycontainer/blobs/log",
      "subjectEndsWith": ".jpg",
      "isSubjectCaseSensitive ": "true"
    }
  }
}

Passos seguintes

Para obter uma introdução ao Event Grid, consulte O que é o Event Grid?

Partilhar via