Event Grid サブスクリプション スキーマ

Event Grid サブスクリプションを作成するには、 Create Event サブスクリプション操作に対して要求を送信します。 次の形式を使用します。

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

たとえば、examplegroup という名前のリソース グループに、examplestorage という名前のストレージ アカウントのイベント サブスクリプションを作成するには、次の形式を使用します。

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

イベント サブスクリプションの名前は、長さが 3 から 64 文字でなければならず、使用できるのは a から z、A から Z、0 から 9、"-" だけです。 この記事は、要求の本体のプロパティとスキーマについて説明します。  

イベント サブスクリプションのプロパティ

プロパティ Type [説明]
destination object エンドポイントを定義するオブジェクト。
filter object イベントの種類をフィルター処理するための省略可能なフィールド。

対象オブジェクト

プロパティ Type 説明
endpointType string サブスクリプションのエンドポイントの種類 (webhook/HTTP、イベント ハブ、またはキュー)。
endpointUrl string このイベント サブスクリプションのイベントの送信先 URL。

フィルター オブジェクト

プロパティ Type 説明
includedEventTypes array イベント メッセージのイベントの種類がこれらのイベントの種類名のいずれかと完全に一致した場合に、適合します。 イベント名がイベント ソースに対して登録済みのイベントの種類名と一致しない場合は、エラーを発生させます。 既定では、すべてのイベントの種類と一致します。
subjectBeginsWith string イベント メッセージの件名フィールドに対する、プレフィックス一致のフィルター。 既定値または空の文字列はすべて一致します。
subjectEndsWith string イベント メッセージの件名フィールドに対する、サフィックス一致のフィルター。 既定値または空の文字列はすべて一致します。
isSubjectCaseSensitive string フィルターの大文字小文字の一致を制御します。
enableAdvancedFilteringOnArrays boolean 高度なフィルター処理でキーの配列を使用できるようにします。 詳細については、高度なフィルター処理に関するページを参照してください。

サブスクリプション スキーマの例

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

次のステップ

  • Event Grid の概要については、Event Grid の紹介に関する記事を参照してください。