Event Grid-abonnementsschema

Artikel
06/01/2023

Als u een Event Grid-abonnement wilt maken, verzendt u een aanvraag naar de bewerking Gebeurtenisabonnement maken. Gebruik de volgende indeling:

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

Als u bijvoorbeeld een gebeurtenisabonnement wilt maken voor een opslagaccount met de naam examplestorage in een resourcegroep met de naam examplegroup, gebruikt u de volgende indeling:

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

De naam van het gebeurtenisabonnement moet 3-64 tekens lang zijn en mag alleen a-z, A-Z, 0-9 en '-' bevatten. In het artikel worden de eigenschappen en het schema voor de hoofdtekst van de aanvraag beschreven.

Eigenschappen van gebeurtenisabonnement

Eigenschap	Type	Description
doel	object	Het object dat het eindpunt definieert.
filter	object	Een optioneel veld voor het filteren van de typen gebeurtenissen.

doelobject

Eigenschap	Type	Description
endpointType	tekenreeks	Het type eindpunt voor het abonnement (webhook/HTTP, Event Hub of wachtrij).
endpointUrl	tekenreeks	De doel-URL voor gebeurtenissen in dit gebeurtenisabonnement.

filterobject

Eigenschap	Type	Description
includedEventTypes	matrix	Overeenkomst wanneer het gebeurtenistype in het gebeurtenisbericht exact overeenkomt met een van deze gebeurtenistypenamen. Er wordt een fout gegenereerd wanneer de naam van de gebeurtenis niet overeenkomt met de namen van het geregistreerde gebeurtenistype voor de gebeurtenisbron. De standaardwaarde komt overeen met alle gebeurtenistypen.
subjectBeginsWith	tekenreeks	Een filter voor voorvoegselovereenkomst met het onderwerpveld in het gebeurtenisbericht. De standaardtekenreeks of de lege tekenreeks komt overeen met alle.
subjectEndsWith	tekenreeks	Een achtervoegselfilter voor het onderwerpveld in het gebeurtenisbericht. De standaardtekenreeks of de lege tekenreeks komt overeen met alle.
isSubjectCaseSensitive	tekenreeks	Hiermee bepaalt u hoofdlettergevoelige overeenkomsten voor filters.
enableAdvancedFilteringOnArrays	booleaans	Hiermee schakelt u het gebruik van matrices voor sleutels in geavanceerd filteren in. Zie Geavanceerd filteren voor meer informatie.

Voorbeeld van abonnementsschema

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

Volgende stappen

Zie Wat is Event Grid? voor een inleiding tot Event Grid.

Delen via