Azure Event Grid イベント スキーマ

この記事では Event Grid スキーマについて説明します。これは、拡張不能だが完全に機能する独自のイベント形式です。 Event Grid では依然としてこのイベント形式がサポートされており、今後も引き続きサポートされます。 ただし、使用が推奨されているイベント形式は CloudEvents です。 Event Grid 形式を使用するアプリケーションを使用している場合は、[CloudEvents] セクションに、Event Grid でサポートされている Event Grid と CloudEvents 形式の間の変換について説明した情報が役立つ場合があります。

この記事では、Event Grid 形式のプロパティとスキーマについて詳しく説明します。 イベントは、4 つの必須文字列プロパティから構成されます。 プロパティは、すべてのイベントに共通であり、公開元を問いません。 データ オブジェクトには、各公開元に固有のプロパティが含まれています。 システム トピックの場合、これらのプロパティは、リソース プロバイダー (Azure Storage や Azure Event Hubs など) に固有です。

イベント ソースは、複数のイベント オブジェクトを含めることができる配列で Azure Event Grid にイベントを送信します。 Event Grid トピックにイベントを送信するとき、配列の合計サイズは最大 1 MB です。 配列内の各イベントは 1 MB に制限されます。 イベントまたは配列がサイズ制限を超えた場合は、[413 ペイロードが大きすぎます] という応答を受信します。 ただし、操作は 64 KB 単位で課金されます。 そのため、64 KB を超えるイベントでは、複数のイベントが発生したかのように操作の料金が発生します。 たとえば、130 KB のイベントでは、3 つの独立したイベントの場合と同じ操作が発生します。

Event Grid は、1 つのイベントを含む配列でサブスクライバーにイベントを送信します。 この動作は、将来変更される可能性があります。

Event Grid イベントおよび各 Azure パブリッシャーのデータ ペイロードの JSON スキーマは、イベント スキーマ ストアにあります。

イベント スキーマ

すべてのイベント発行元に使用されているプロパティの例を次に示します。

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

たとえば、Azure BLOB ストレージ イベントに対して次のようなスキーマが発行されます。

[
  {
    "topic": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/contosostorage",
    "subject": "/blobServices/default/containers/testcontainer/blobs/dataflow.jpg",
    "eventType": "Microsoft.Storage.BlobCreated",
    "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "data": {
      "api": "PutBlob",
      "clientRequestId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "requestId": "cccccccc-2222-3333-4444-dddddddddddd",
      "eTag": "0x8DD15A69488FE5A",
      "contentType": "image/jpeg",
      "contentLength": 52577,
      "blobType": "BlockBlob",
      "accessTier": "Default",
      "url": "https://contosostorage.blob.core.windows.net/testcontainer/dataflow.jpg",
      "sequencer": "0000000000000000000000000003A13C00000000007da85d",
      "storageDiagnostics": {
        "batchId": "9d292d9f-e006-00a5-008f-47b300000000"
      }
    },
    "dataVersion": "",
    "metadataVersion": "1",
    "eventTime": "2024-12-06T03:32:15.7238874Z"
  }
]

イベントのプロパティ

すべてのイベントには、次の同じ最上位レベルのデータが含まれています。

データ オブジェクトのプロパティの詳細については、このセクションの記事を参照してください: System トピック。

カスタム トピックの場合、イベントの発行元がデータ オブジェクトを決定します。 最上位レベルのデータには、リソースによって定義された標準のイベントと同じフィールドを含める必要があります。

イベントをカスタム トピックに発行する場合は、サブスクライバーがそのイベントに関心があるかどうかを簡単に知ることができるイベントの件名を作成してください。 サブスクライバーは、その件名を使用してイベントをフィルター処理したり、ルーティングしたりします。 そのイベントが発生したパスを示すことにより、サブスクライバーがそのパスのセグメントでフィルター処理できるように考慮してください。 このパスにより、サブスクライバーはイベントを狭く、または幅広くフィルター処理できます。 たとえば、/A/B/C のように件名に 3 つのセグメント パスを示した場合、サブスクライバーは最初のセグメント /A でフィルター処理して幅広い一連のイベントを取得できます。 これらのサブスクライバーは、/A/B/C や /A/D/E などの件名を持つイベントを取得します。 他のサブスクライバーは、/A/B でフィルター処理して、より狭い一連のイベントを取得できます。

場合によっては、件名には発生した事象についてより詳細な情報が必要です。 たとえば、コンテナーにファイルが追加された場合、ストレージ アカウント パブリッシャーは件名 /blobServices/default/containers/<container-name>/blobs/<file> を指定します。 サブスクライバーはパス /blobServices/default/containers/<container-name>/ でフィルター処理することにより、ストレージ アカウント内の他のコンテナーではなく、そのコンテナーのすべてのイベントを取得できます。 サブスクライバーはまた、テキスト ファイルのみを操作するために、サフィックス .txt でフィルター処理またはルーティングすることもできます。

CloudEvents

CloudEvents は、使用が推奨されているイベント形式です。 Azure Event Grid では、少なくとも CloudEvents JSON 形式に関連する機能への投資が継続されています。 Azure サービスなどの一部のイベント ソースで Event Grid 形式が使用されているという事実を考慮し、CloudEvents 形式と Event Grid 形式を、トピックの入力スキーマとして、およびイベント サブスクリプションの出力スキーマとして使用する場合に、サポートされる変換を理解するのに役立つ次の表を示します。 CloudEvents では、Event Grid スキーマではサポートされていない拡張属性がサポートされているため、CloudEvents を入力スキーマとして使用する場合は Event Grid 出力スキーマを使用できません。

次のステップ

• Azure Event Grid の概要については、Event Grid の紹介に関する記事を参照してください。
• Azure Event Grid サブスクリプションの作成の詳細については、Event Grid サブスクリプション スキーマに関する記事を参照してください。