Event Grid-prenumerationsschema

  • Artikel

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