4.2. API エンドポイント


以下の API エンドポイントを利用できます。

  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log

    • GET: 指定された Build のログを読み取る

4.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log

表4.1 グローバルパスパラメーター
パラメーター説明

name

string

BuildLog の名前

namespace

string

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

表4.2 グローバルクエリーパラメーター
パラメーター説明

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' の場合、出力はきれいに印刷されます。

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

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

HTTP メソッド
GET
Description
指定された Build のログを読み取る
表4.3 HTTP 応答
HTTP コード応答本文

200 - OK

BuildLog スキーマ

401 - Unauthorized

空白

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.