Event Grid előfizetési sémaEvent Grid subscription schema

Event Grid előfizetés létrehozásához küld egy kérést az esemény-előfizetés létrehozása művelethez.To create an Event Grid subscription, you send a request to the Create Event subscription operation. Használja az alábbi formátumot:Use the following format:

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

Ha például egy nevű erőforráscsoporthoz tartozó Storage-fiókhoz szeretne esemény-előfizetést létrehozni examplestorage examplegroup , használja a következő formátumot:For example, to create an event subscription for a storage account named examplestorage in a resource group named examplegroup, use the following format:

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

Az esemény-előfizetés nevének 3-64 karakter hosszúnak kell lennie, és csak a-z, A-Z, 0-9 és a "-" karaktereket tartalmazhat.The Event Subscription name must be 3-64 characters in length and can only contain a-z, A-Z, 0-9, and "-". A cikk a kérelem törzsének tulajdonságait és sémáját ismerteti.The article describes the properties and schema for the body of the request.

Esemény-előfizetés tulajdonságaiEvent subscription properties

TulajdonságProperty TípusType DescriptionDescription
destinationdestination objectobject A végpontot meghatározó objektum.The object that defines the endpoint.
filter (szűrő)filter objectobject Egy választható mező az események típusának szűréséhez.An optional field for filtering the types of events.

célobjektumdestination object

TulajdonságProperty TípusType DescriptionDescription
endpointTypeendpointType sztringstring Az előfizetés végpontjának típusa (webhook/HTTP, Event hub vagy üzenetsor).The type of endpoint for the subscription (webhook/HTTP, Event Hub, or queue).
endpointUrlendpointUrl sztringstring Az esemény-előfizetésben szereplő események céljának URL-címe.The destination URL for events in this event subscription.

objektum szűrésefilter object

TulajdonságProperty TípusType DescriptionDescription
includedEventTypesincludedEventTypes arrayarray Egyezés, ha az eseményben szereplő eseménytípus pontos egyezést mutat az adott eseménytípus egyikének megadásához.Match when the event type in the event message is an exact match to one of these event type names. Hibát jelez, ha az esemény neve nem egyezik az eseményforrás regisztrált eseménytípus nevével.Raises an error when event name does not match the registered event type names for the event source. Az alapértelmezett érték minden eseménytípus esetében megfelel.Default matches all event types.
subjectBeginsWithsubjectBeginsWith sztringstring Előtag – az üzenet tárgy mezőjének megfelelő szűrő.A prefix-match filter to the subject field in the event message. Az alapértelmezett vagy az üres karakterlánc mindennek megfelel.The default or empty string matches all.
subjectEndsWithsubjectEndsWith sztringstring Utótag – az esemény üzenet tárgy mezőjének megfelelő szűrő.A suffix-match filter to the subject field in the event message. Az alapértelmezett vagy az üres karakterlánc mindennek megfelel.The default or empty string matches all.
isSubjectCaseSensitiveisSubjectCaseSensitive sztringstring A kis-és nagybetűk megkülönböztetését szabályozza a szűrőkhöz.Controls case-sensitive matching for filters.
enableAdvancedFilteringOnArraysenableAdvancedFilteringOnArrays booleanboolean Lehetővé teszi a tömbök használatát a speciális szűrési kulcsokhoz.Enables using arrays for keys in advanced filtering. További információ: speciális szűrés.For more information, see Advanced filtering.

Példa előfizetési sémáraExample subscription schema

{
  "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/log",
      "subjectEndsWith": ".jpg",
      "isSubjectCaseSensitive ": "true"
    }
  }
}

Következő lépésekNext steps