Event Grid-Abonnementschema

  • Artikel

Zum Erstellen eines Event Grid-Abonnements senden Sie eine Anforderung an den Vorgang zum Erstellen eines Ereignisabonnements. Verwenden Sie das folgende 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

Verwenden Sie also beispielsweise Folgendes, um ein Ereignisabonnement für ein Speicherkonto namens examplestorage in einer Ressourcengruppe namens examplegroup zu erstellen:

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

Der Name des Ereignisabonnements muss 3 bis 64 Zeichen umfassen und darf nur die Zeichen a–Z, A–Z, 0–9 und „-“ enthalten. Der Artikel beschreibt die Eigenschaften und das Schema für den Hauptteil der Anforderung.  

Eigenschaften für Ereignisabonnements

Eigenschaft type Beschreibung
destination Objekt (object) Das Objekt, das den Endpunkt definiert.
filter Objekt (object) Ein optionales Feld zum Filtern der Ereignistypen.

destination-Objekt

Eigenschaft type BESCHREIBUNG
endpointType Zeichenfolge Die Art des Endpunkts für das Abonnement (Webhook/HTTP, Event Hub oder Warteschlange).
endpointUrl Zeichenfolge Die Ziel-URL für Ereignisse in diesem Ereignisabonnement.

filter-Objekt

Eigenschaft type BESCHREIBUNG
includedEventTypes array Übereinstimmung, wenn der Ereignistyp in der Ereignisnachricht eine exakte Übereinstimmung für einen der Ereignistypnamen ist. Fehler, wenn der Ereignisname nicht den registrierten Ereignistypnamen für die Ereignisquelle entspricht. Der Standardwert entspricht allen Ereignistypen.
subjectBeginsWith Zeichenfolge Ein Präfixabgleichfilter für das Betrefffeld in der Ereignisnachricht. Der Standardwert oder eine leere Zeichenfolge entspricht allen Optionen.
subjectEndsWith Zeichenfolge Ein Suffixabgleichfilter für das Betrefffeld in der Ereignisnachricht. Der Standardwert oder eine leere Zeichenfolge entspricht allen Optionen.
isSubjectCaseSensitive Zeichenfolge Steuert, ob beim Abgleich von Filtern die Groß-/Kleinschreibung beachtet wird.
enableAdvancedFilteringOnArrays boolean Ermöglicht die Verwendung von Arrays für Schlüssel in der erweiterten Filterung. Weitere Informationen finden Sie unter Erweiterte Filterung.

Beispiel für das Abonnementschema

{
  "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ächste Schritte