16.2. API エンドポイント

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

/apis/config.openshift.io/v1/ingresses
- DELETE: 入力のコレクションを削除します
- GET:Ingress の種類のオブジェクトをリスト表示します
- POST: 入力を作成します
/apis/config.openshift.io/v1/ingresses/{name}
- 削除: 入力を削除します
- GET: 指定された入力を読み取ります
- PATCH: 指定された入力を部分的に更新します
- PUT: 指定された入力を置き換えます
/apis/config.openshift.io/v1/ingresses/{name}/status
- GET: 指定された入力のステータスを読み取ります
- PATCH: 指定された入力のステータスを部分的に更新します
- PUT: 指定された入力のステータスを置き換えます

16.2.1. /apis/config.openshift.io/v1/ingresses
リンクのコピー

HTTP メソッド: DELETE
説明: Ingress のコレクションを削除します

Expand

表16.1 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`Status` スキーマ
401 - Unauthorized	空白

HTTP メソッド: GET
説明: Ingress の種類のオブジェクトをリスト表示します

Expand

表16.2 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`IngressList` スキーマ
401 - Unauthorized	空白

HTTP メソッド: POST
説明: イングレスを作成する

Expand

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

Expand

表16.4 ボディのパラメーター
パラメーター	型	説明
`body`	`Ingress` スキーマ

Expand

表16.5 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
201 - Created	`Ingress` スキーマ
202 - Accepted	`Ingress` スキーマ
401 - Unauthorized	空白

16.2.2. /apis/config.openshift.io/v1/ingresses/{name}
リンクのコピー

Expand

表16.6 グローバルパスパラメーター
パラメーター	型	説明
`name`	`string`	イングレスの名前

HTTP メソッド: DELETE
説明: 入力を削除します

Expand

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

Expand

表16.8 HTTP レスポンス
HTTP コード	レスポンスのボディー
200 - OK	`Status` スキーマ
202 - Accepted	`Status` スキーマ
401 - Unauthorized	空白

HTTP メソッド: GET
説明: 指定された入力を読み取ります

Expand

表16.9 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
401 - Unauthorized	空白

HTTP メソッド: PATCH
説明: 指定された入力を部分的に更新します

Expand

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

Expand

表16.11 HTTP レスポンス
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
401 - Unauthorized	空白

HTTP メソッド: PUT
説明: 指定された入力を置き換えます

Expand

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

Expand

表16.13 ボディのパラメーター
パラメーター	型	説明
`body`	`Ingress` スキーマ

Expand

表16.14 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
201 - Created	`Ingress` スキーマ
401 - Unauthorized	空白

16.2.3. /apis/config.openshift.io/v1/ingresses/{name}/status
リンクのコピー

Expand

表16.15 グローバルパスパラメーター
パラメーター	型	説明
`name`	`string`	イングレスの名前

HTTP メソッド: GET
説明: 指定された入力のステータスを読み取ります

Expand

表16.16 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
401 - Unauthorized	空白

HTTP メソッド: PATCH
説明: 指定された入力のステータスを部分的に更新します

Expand

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

Expand

表16.18 HTTP レスポンス
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
401 - Unauthorized	空白

HTTP メソッド: PUT
説明: 指定された入力のステータスを置き換えます

Expand

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

Expand

表16.20 ボディのパラメーター
パラメーター	型	説明
`body`	`Ingress` スキーマ

Expand

表16.21 HTTP 応答
HTTP コード	レスポンスのボディー
200 - OK	`Ingress` スキーマ
201 - Created	`Ingress` スキーマ
401 - Unauthorized	空白

トップに戻る

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat