Event Grid-Abonnementschema

Artikel
06/01/2023

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

Eine Einführung zu Event Grid finden Sie unter Informationen zu Event Grid.

Freigeben über