Azure Event Grid イベントスキーマ

2025-05-20

この記事では 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 スキーマは、イベントスキーマストアにあります。

注

Event Grid イベントスキーマのサポートは廃止される予定はありませんが、今後大幅な改善は行われません。イベントの構造とメタデータの説明の標準化されたプロトコルに依存しない定義を提供する CloudEvents スキーマを使用することをお勧めします。詳細については、Azure Event Grid を使用した CloudEvents v1.0 スキーマを参照してください。

イベントスキーマ

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

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

イベントのプロパティ

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

プロパティ	タイプ	必須	説明
`topic`	ひも	いいえ。ただし、追加する場合は、Event Grid トピックの Azure Resource Manager ID と完全に一致させる必要があります。追加しなかった場合は、Event Grid によってイベントに記録されます。	イベントソースの完全なリソースパス。このフィールドは書き込み可能ではありません。この値は Event Grid によって指定されます。
`subject`	ひも	はい	発行元が定義したイベントの対象のパス。
`eventType`	ひも	はい	このイベントソース用に登録されたイベントの種類のいずれか。
イベント時間	ひも	はい	プロバイダーの UTC 時刻に基づくイベントの生成時刻。
`id`	ひも	はい	イベントの一意識別子。
`data`	オブジェクト	はい	リソースプロバイダーに固有のイベントデータ。
`dataVersion`	ひも	いいえ。ただし、空の値が記録されます。	データオブジェクトのスキーマバージョン。スキーマバージョンは発行元によって定義されます。
`metadataVersion`	ひも	必須ではありませんが、追加する場合は、Event Grid スキーマの `metadataVersion` と完全に一致させる必要があります (現在は `1` のみ)。追加しなかった場合は、Event Grid によってイベントに記録されます。	イベントメタデータのスキーマバージョン。最上位プロパティのスキーマは Event Grid によって定義されます。この値は Event Grid によって指定されます。

データオブジェクトのプロパティの詳細については、このセクションの記事を参照してください: 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 出力スキーマを使用できません。

入力スキーマ	出力スキーマ
CloudEvents 形式	CloudEvents 形式
Event Grid 形式	CloudEvents 形式
Event Grid 形式	Event Grid 形式

サポートされているスキーマのバージョン

Event Grid では現在、次のスキーマバージョンがサポートされています。

Event Grid スキーマ: バージョン 1.0
CloudEvents スキーマ: CloudEvents1.0に従ったバージョン

次のステップ

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

次の方法で共有

Azure Event Grid イベント スキーマ

イベント スキーマ

イベントのプロパティ

CloudEvents

サポートされているスキーマ のバージョン

次のステップ

フィードバック

その他のリソース

Azure Event Grid イベントスキーマ

イベントスキーマ

サポートされているスキーマのバージョン