8.2. API エンドポイント


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

  • /apis/image.openshift.io/v1/imagestreams

    • GET:ImageStream の種類のオブジェクトをリスト表示または監視します
  • /apis/image.openshift.io/v1/watch/imagestreams

    • GET: ImageStream のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
  • /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams

    • DELETE:ImageStream のコレクションを削除します
    • GET:ImageStream の種類のオブジェクトをリスト表示または監視します
    • POST:ImageStream を作成します
  • /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams

    • GET: ImageStream のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
  • /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}

    • 削除:ImageStream を削除します
    • GET: 指定された ImageStream を読み取ります
    • PATCH: 指定された ImageStream を部分的に更新します
    • PUT: 指定された ImageStream を置き換えます
  • /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}

    • GET:ImageStream の種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
  • /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status

    • GET: 指定された ImageStream のステータスを読み取ります
    • PATCH: 指定された ImageStream のステータスを部分的に更新します
    • PUT: 指定された ImageStream のステータスを置き換えます

8.2.1. /apis/image.openshift.io/v1/imagestreams

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示または監視する ImageStream
表8.1 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStreamList スキーマ

401 - Unauthorized

空白

8.2.2. /apis/image.openshift.io/v1/watch/imagestreams

HTTP メソッド
GET
説明
ImageStream のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
表8.2 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

WatchEvent スキーマ

401 - Unauthorized

空白

8.2.3. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams

HTTP メソッド
DELETE
説明
ImageStream のコレクションを削除します
表8.3 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表8.4 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status_v5 スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
種類のオブジェクトをリスト表示または監視する ImageStream
表8.5 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStreamList スキーマ

401 - Unauthorized

空白

HTTP メソッド
POST
説明
ImageStream を作成します
表8.6 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.7 ボディのパラメーター
パラメーター説明

body

ImageStream スキーマ

 
表8.8 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

201 - Created

ImageStream スキーマ

202 - Accepted

ImageStream スキーマ

401 - Unauthorized

空白

8.2.4. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams

HTTP メソッド
GET
説明
ImageStream のリストに対する個々の変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用してください。
表8.9 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

WatchEvent スキーマ

401 - Unauthorized

空白

8.2.5. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}

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

name

string

ImageStream の名前です。

HTTP メソッド
DELETE
説明
ImageStream を削除します
表8.11 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

表8.12 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

Status_v5 スキーマ

202 - Accepted

Status_v5 スキーマ

401 - Unauthorized

空白

HTTP メソッド
GET
説明
指定された ImageStream を読み取ります
表8.13 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ImageStream を部分的に更新します
表8.14 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.15 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

201 - Created

ImageStream スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ImageStream を置き換えます
表8.16 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.17 ボディのパラメーター
パラメーター説明

body

ImageStream スキーマ

 
表8.18 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

201 - Created

ImageStream スキーマ

401 - Unauthorized

空白

8.2.6. /apis/image.openshift.io/v1/watch/namespaces/{namespace}/imagestreams/{name}

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

name

string

ImageStream の名前です。

HTTP メソッド
GET
説明
ImageStream の種類のオブジェクトへの変更を監視します。非推奨: 代わりに、リスト操作で 'watch' パラメーターを使用し、'fieldSelector' パラメーターで単一の項目にフィルター処理します。
表8.20 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

WatchEvent スキーマ

401 - Unauthorized

空白

8.2.7. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreams/{name}/status

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

name

string

ImageStream の名前です。

HTTP メソッド
GET
説明
指定された ImageStream のステータスを読み取ります
表8.22 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ImageStream のステータスを部分的に更新します
表8.23 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.24 HTTP レスポンス
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

201 - Created

ImageStream スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ImageStream のステータスを置き換えます
表8.25 クエリーパラメーター
パラメーター説明

dryRun

string

これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合はエラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべてのドライランステージが処理されます。

fieldValidation

string

fieldValidation は、不明なフィールドまたは重複したフィールドを含むリクエスト (POST/PUT/PATCH) 内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは、v1.23 より前のデフォルトの動作です。- Warn: オブジェクトから削除された不明なフィールドごと、および検出された重複フィールドごとに、標準の警告応答ヘッダーを介して警告が送信されます。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは v1.23 以降のデフォルトです。- Strict: 不明なフィールドがオブジェクトから削除される場合、または重複フィールドが存在する場合、リクエストは BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。

表8.26 ボディのパラメーター
パラメーター説明

body

ImageStream スキーマ

 
表8.27 HTTP 応答
HTTP コードレスポンスのボディー

200 - OK

ImageStream スキーマ

201 - Created

ImageStream スキーマ

401 - Unauthorized

空白

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.