PingSourceリファレンス

このトピックでは、PingSourceオブジェクトの構成可能なフィールドに関するリファレンス情報を提供します。

PingSource

PingSource定義は、次のフィールドをサポートします。

フィールド	説明	必須またはオプション
apiVersion	APIバージョンを指定します。たとえば、sources.knative.dev/v1。	必須
kind	このリソースオブジェクトをPingSourceオブジェクトとして識別します。	必須
metadata	PingSourceオブジェクトを一意に識別するメタデータを指定します。たとえば、name。	必須
spec	このPingSourceオブジェクトの構成情報を指定します。	必須
spec.contentType	dataまたはdataBase64のメディアタイプ。デフォルトは空です。	オプション
spec.data	シンクにポストされるイベントの本文として使用されるデータ。デフォルトは空です。dataBase64とは相互に排他的です。	base64エンコードされたデータを送信しない場合は必須
spec.dataBase64	シンクにポストされる実際のイベントの本文のbase64エンコードされた文字列。デフォルトは空です。dataとは相互に排他的です。	base64エンコードされたデータを送信する場合は必須
spec.schedule	cronスケジュールを指定します。デフォルトは* * * * *です。	オプション
spec.sink	シンクとして使用するURIに解決されるオブジェクトへの参照。	必須
spec.timezone	指定されたタイムゾーンを基準とした実際の時間を変更します。デフォルトはシステムタイムゾーンです。 Wikipediaの有効なtzデータベースタイムゾーンの一覧を参照してください。タイムゾーンに関する一般的な情報については、IANAのWebサイトを参照してください。	オプション
spec.ceOverrides	シンクに送信されるイベントの出力形式と変更を制御するためのオーバーライドを定義します。	オプション
status	PingSourceの観測された状態を定義します。	オプション
status.observedGeneration	コントローラーによって最後に処理されたサービスの「世代」。	オプション
status.conditions	リソースの現在の状態に関する最新の観測結果。	オプション
status.sinkUri	ソースに構成された現在アクティブなシンクURI。	オプション

CloudEventオーバーライド

CloudEventオーバーライドは、シンクに送信されるイベントの出力形式と変更を制御するためのオーバーライドを定義します。

ceOverrides定義は、次のフィールドをサポートします。

フィールド	説明	必須またはオプション
extensions	アウトバウンドイベントに追加またはオーバーライドされる属性を指定します。各extensionsキーと値のペアは、属性拡張としてイベントに個別に設定されます。	オプション

注記

CloudEvent属性名のみが拡張機能として許可されています。拡張機能のオーバーライド構成から仕様で定義された属性を設定することはできません。たとえば、type属性を変更することはできません。

例：CloudEventオーバーライド

apiVersion: sources.knative.dev/v1
kind: PingSource
metadata:
  name: test-heartbeats
spec:
  ...
  ceOverrides:
    extensions:
      extra: this is an extra attribute
      additional: 42

コントラクト

これにより、K_CE_OVERRIDES環境変数が次のようにsubjectに設定されます。

{ "extensions": { "extra": "this is an extra attribute", "additional": "42" } }