Event Grid-prenumerationsschema

Artikel
06/01/2023

Om du vill skapa en Event Grid-prenumeration skickar du en begäran till åtgärden Skapa händelseprenumeration. Använd följande 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

Om du till exempel vill skapa en händelseprenumeration för ett lagringskonto med namnet examplestorage i en resursgrupp med namnet examplegroupanvänder du följande format:

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

Namnet på händelseprenumerationen måste vara mellan 3 och 64 tecken långt och får bara innehålla a-z, A-Z, 0-9 och "-". Artikeln beskriver egenskaperna och schemat för brödtexten i begäran.

Egenskaper för händelseprenumeration

Egenskap	Typ	Beskrivning
mål	objekt	Objektet som definierar slutpunkten.
filter	objekt	Ett valfritt fält för filtrering av händelsetyper.

målobjekt

Egenskap	Typ	Beskrivning
endpointType	sträng	Typ av slutpunkt för prenumerationen (webhook/HTTP, Event Hub eller kö).
endpointUrl	sträng	Mål-URL:en för händelser i den här händelseprenumerationen.

filterobjekt

Egenskap	Typ	Beskrivning
includedEventTypes	matris	Matcha när händelsetypen i händelsemeddelandet är en exakt matchning till ett av dessa namn på händelsetypen. Genererar ett fel när händelsenamnet inte matchar de registrerade händelsetypsnamnen för händelsekällan. Standard matchar alla händelsetyper.
subjectBeginsWith	sträng	Ett prefixmatchningsfilter till ämnesfältet i händelsemeddelandet. Standardsträngen eller den tomma strängen matchar alla.
subjectEndsWith	sträng	Ett suffixmatchningsfilter till ämnesfältet i händelsemeddelandet. Standardsträngen eller den tomma strängen matchar alla.
isSubjectCaseSensitive	sträng	Styr skiftlägeskänslig matchning för filter.
enableAdvancedFilteringOnArrays	boolean	Aktiverar användning av matriser för nycklar i avancerad filtrering. Mer information finns i Avancerad filtrering.

Exempel på prenumerationsschema

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

Nästa steg

En introduktion till Event Grid finns i Vad är Event Grid?

Dela via