Esquema de suscripción de Event Grid

  • Artículo

Para crear una suscripción de Event Grid, se envía una solicitud a la operación de suscripción Crear evento. Utilice el siguiente 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 ejemplo, con el fin de crear una suscripción de eventos para una cuenta de almacenamiento denominada "examplestorage" en un grupo de recursos llamado examplegroup, utilice el formato siguiente:

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

El nombre de la suscripción de eventos debe tener entre 3 y 64 caracteres de longitud y solo puede contener los siguientes caracteres: a-z, A-z, 0-9, y "-". En el artículo se describen las propiedades y el esquema del cuerpo de la solicitud.  

Propiedades de la suscripción de eventos

Propiedad Tipo Descripción
destination object El objeto que define el punto de conexión.
filter object Un campo opcional para filtrar los tipos de eventos.

Objeto de destino

Propiedad Tipo Descripción
endpointType string El tipo de punto de conexión de la suscripción (webhook/HTTP, centro de eventos o cola).
endpointUrl string Dirección URL de destino de los eventos en esta suscripción a eventos.

Objeto de filtro

Propiedad Tipo Descripción
includedEventTypes array Realiza la correspondencia cuando el tipo de evento del mensaje de evento es una coincidencia exacta con uno de estos nombres de tipo de evento. Genera un error cuando el nombre del evento no coincide con los nombres de tipo de evento registrados para el origen del evento. El valor predeterminado coincide con todos los tipos de evento.
subjectBeginsWith string Un filtro de coincidencia de prefijo en el campo de asunto del mensaje del evento. El valor predeterminado o una cadena vacía coincide con todos los tipos de evento.
subjectEndsWith string Un filtro de coincidencia de sufijo en el campo de asunto del mensaje del evento. El valor predeterminado o una cadena vacía coincide con todos los tipos de evento.
isSubjectCaseSensitive string Controla la coincidencia que distingue mayúsculas de minúsculas en los filtros.
enableAdvancedFilteringOnArrays boolean Habilita el uso de matrices para claves en el filtrado avanzado. Para obtener más información, consulte Filtrado avanzado.

Esquema de suscripción de ejemplo

{
  "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"
    }
  }
}

Pasos siguientes

  • Para ver una introducción a Event Grid, consulte el artículo acerca de qué es Event Grid.