CloudEvents 格式 - HTTP 通訊協定繫結

CloudEvents (cloudevents.io) 是一種規格，可採用通用方式描述事件資料。這項規格由雲端原生運算基金會 (CNCF) 負責，並由 CNCF 的無伺服器工作組管理。

Eventarc 會透過 HTTP 要求，以 CloudEvents 格式將事件傳送至事件接收器。

HTTP 要求標頭

目標服務會以 HTTP POST 要求的形式，從事件路由器接收事件，這些要求會根據 CloudEvents 1.0 版的 HTTP 通訊協定繫結規格格式化。每個 HTTP 要求都包含事件專屬的標頭和主體，並傳送至服務的根網址路徑 (/)。

除了其他 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 Buffers
• 產生的 JSON 結構定義
• 公開的 JSON 結構定義目錄

同時也會提供用戶端程式庫的連結。

常見活動

通訊協定緩衝區 (或 protobuf) 代表 Eventarc 產生的事件中的資料。CloudEvents 的通訊協定緩衝區以機器可讀取的結構定義形式提供，可建立資料型別程式庫，方便使用事件。

與任何 CloudEvent 類型相關的 protobuf 訊息有兩種：

• 代表完整 CloudEvent 的封包訊息，包括任何擴充屬性，例如 AuditLogWrittenEvent。
• 資料訊息，例如 LogEntryData 或 StorageObjectData。

下表詳細列出一些常見事件的元件：

後續步驟

進一步瞭解事件路徑。