CloudEvents 形式 - HTTP プロトコル バインディング

CloudEvents（cloudevents.io）は、イベントデータを一般的な方��で記述するための仕様です。この仕様は、Cloud Native Computing Foundation（CNCF）の Serverless Working Group によって編成されています。

Eventarc は、HTTP リク��ストを���用して CloudEvents 形式でイベント レシーバにイベントを配信します。

HTTP リクエスト ヘッダー

ターゲット サービスは、CloudEvents バージョン 1.0 HTTP プロトコル バインディング仕様の形式で HTTP POST リクエストとしてイベント ルーターからイベントを受信します。各 HTTP リクエストにはイベント固有のヘッダーと本文が含まれ、サービスのルート URL パス（/）に送信されます。

他の HTTP ヘッダーに加えて、すべてのイベントに次の CloudEvents HTTP ヘッダーがあります。

HTTP ペイロードの形式

ce-specversion: 1.0
ce-type: google.cloud.audit.log.v1.written
ce-source: //SERVICE_NAME/projects/PROJECT_ID
ce-id: MESSAGE_ID
ce-time: PUBLISH_TIME
Content-Type: application/json; charset=utf-8
Content-Length: CONTENT_LENGTH

ce-specversion: 1.0
ce-type: google.cloud.pubsub.topic.v1.messagePublished
ce-source: //pubsub.googleapis.com/TOPIC
ce-id: MESSAGE_ID
ce-time: PUBLISH_TIME
Content-Type: application/json; charset=utf-8
Content-Length: CONTENT_LENGTH

オープンソース リポジトリ

すべてのイベントの HTTP 本文の構造は、CloudEvents GitHub リポジトリで入手できます。

リポジトリには、CloudEvents データを理解して、お使いのプログラミング言語で使用する際に役立つものが用意されています。

• CloudEvents データ ペイロード用の Google Protocol Buffer
• 生成された JSON スキーマ
• 公開 JSON スキーマ カタログ

クライアント ライブラリへのリンクも含まれます。

一般的なイベント

プロトコル バッファ（protobuf）は、Eventarc によって生成されたイベント内のデータを表します。CloudEvents のプロトコル バッファは機械で読み取り可能なスキーマとして提供されます。これにより、データタイプのライブラリを作成し、イベントを容易に使用できるようになります。

CloudEvent のタイプに関連する protobuf メッセージは 2 つあります。

• 拡張属性を含む CloudEvent 全体を表すエンベロープ メッセージ（例: AuditLogWrittenEvent）
• データ メッセージ。例: LogEntryData、StorageObjectData

次の表に、一般的なイベントのコンポーネントの詳細を示します。

次のステップ

イベントルートの詳細を確認する。