Schemat subskrypcji usługi Event Grid

  • Artykuł

Aby utworzyć subskrypcję usługi Event Grid, należy wysłać żądanie do operacji tworzenia subskrypcji zdarzeń. Użyj następującego formatu:

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

Aby na przykład utworzyć subskrypcję zdarzeń dla konta magazynu o nazwie examplestorage w grupie zasobów o nazwie examplegroup, użyj następującego formatu:

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

Nazwa subskrypcji zdarzeń musi mieć długość od 3 do 64 znaków i może zawierać tylko znaki a-z, A-Z, 0–9 i "-". W tym artykule opisano właściwości i schemat treści żądania.  

Właściwości subskrypcji zdarzeń

Właściwość Typ Opis
destination object Obiekt, który definiuje punkt końcowy.
filter object Opcjonalne pole do filtrowania typów zdarzeń.

obiekt docelowy

Właściwość Typ Opis
Endpointtype ciąg Typ punktu końcowego dla subskrypcji (element webhook/HTTP, centrum zdarzeń lub kolejka).
endpointUrl ciąg Docelowy adres URL zdarzeń w tej subskrypcji zdarzeń.

filtruj obiekt

Właściwość Typ Opis
includedEventTypes array Dopasowanie, gdy typ zdarzenia w komunikacie zdarzenia jest dokładnie zgodny z jedną z tych nazw typów zdarzeń. Zgłasza błąd, gdy nazwa zdarzenia nie jest zgodna z nazwami zarejestrowanych typów zdarzeń dla źródła zdarzeń. Wartość domyślna odpowiada wszystkim typom zdarzeń.
subjectBeginsWith ciąg Filtr dopasowania prefiksu do pola tematu w komunikacie zdarzenia. Domyślny lub pusty ciąg jest zgodny ze wszystkimi.
subjectEndsWith ciąg Filtr dopasowania sufiksu do pola tematu w komunikacie zdarzenia. Domyślny lub pusty ciąg jest zgodny ze wszystkimi.
isSubjectCaseSensitive ciąg Określa dopasowywanie wielkości liter dla filtrów.
enableAdvancedFilteringOnArrays boolean Umożliwia używanie tablic dla kluczy w zaawansowanym filtrowaniu. Aby uzyskać więcej informacji, zobacz Filtrowanie zaawansowane.

Przykładowy schemat subskrypcji

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

Następne kroki