4.2. API エンドポイント

name

string

BuildLog の名前

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

container

string

ログをストリーミングするための cointainer。Pod にコンテナーが 1 つある場合、デフォルトではコンテナーのみになります。

follow

boolean

true の場合は、ビルドが終了するまでビルドログをストリーミングする必要があることを示します。

insecureSkipTLSVerifyBackend

boolean

insecureSkipTLSVerifyBackend は、apiserver が接続先のバックエンドの提供証明書の有効性を確認してはならないことを示します。これにより、apiserver とバックエンド間の HTTPS 接続が安全でなくなります。これは、apiserver が受け取っているログデータが実際の kubelet からのものであることを確認できないことを意味します。kubelet が apiserver の TLS 認証情報を検証するように設定されている場合は、実際の kubelet への接続が中間者攻撃に対して脆弱であることを意味するわけではありません (たとえば、攻撃者は実際の kubelet からの実際のログデータを傍受できませんでした)。

limitBytes

integer

limitBytes (設定されている場合) は、ログ出力を終了する前にサーバーから読み取るバイト数です。これにより、ロギングの完全な最終行が表示されない場合があり、指定された制限よりわずかに多いまたはわずかに少ない値が返される場合があります。

nowait

boolean

noWait を true にすると、ビルドがまだ利用できない場合でも、呼び出しはすぐに戻ります。それ以外の場合、サーバーはビルドが開始するまで待機します。

pretty

string

'true' の場合は、出力が整形表示 (Pretty-print) されます。

previous

boolean

previous は、以前のビルドログを返します。デフォルトは false です。

sinceSeconds

integer

sinceSeconds は、ログを表示する現在の時刻より前の相対時間 (秒単位) です。この値が Pod の開始時刻より前の場合は、Pod の開始以降のログのみが返されます。この値が将来の場合は、ログが返されません。sinceSeconds または sinceTime のいずれか 1 つのみを指定できます。

tailLines

integer

tailLines (設定されている場合) は、表示するログの最後からの行数です。指定しない場合、ログはコンテナーの作成時、sinceSeconds、sinceTime から表示されます

timestamps

boolean

タイムスタンプは、true の場合、ログ出力のすべての行の先頭に RFC3339 または RFC3339Nano タイムスタンプを追加します。デフォルトは false です。

version

integer

ログを表示するビルドのバージョン。

200 - OK

BuildLog スキーマ

401 - Unauthorized

空白