3.2. API エンドポイント

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

/api/v1/namespaces/{namespace}/bindings
- POST: バインディングを作成します
/api/v1/namespaces/{namespace}/pods/{name}/binding
- POST:Pod のバインディングを作成します

3.2.1. /api/v1/namespaces/{namespace}/bindings

表3.1 グローバルパスパラメーター
パラメーター	タイプ	説明
`namespace`	`string`	チームやプロジェクトなどのオブジェクト名と認証スコープ

表3.2 グローバルクエリーパラメーター
パラメーター	タイプ	説明
`dryRun`	`string`	これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。
`fieldManager`	`string`	fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。
`fieldValidation`	`string`	fieldValidation は、`ServerSideFieldValidation` 機能ゲートも有効になっている場合に、不明または重複するフィールドを含むリクエスト(POST/PUT/PATCH)内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは v1.23 以前のデフォルトの動作であり、`ServerSideFieldValidation` フィーチャーゲートが無効な場合のデフォルトの動作です。警告：オブジェクトから削除された不明なフィールドと、発生した重複フィールドごとに、標準の警告応答ヘッダーを介して警告を送信します。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは、`ServerSideFieldValidation` フィーチャーゲートが有効になっている場合のデフォルトです。Strict: オブジェクトから不明なフィールドが削除される場合、または重複するフィールドが存在する場合は、リクエストを BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。
`pretty`	`string`	true の場合は、出力が整形表示 (Pretty-print) されます。

HTTP メソッド: POST
説明: バインディングを作成する

表3.3 本文パラメーター
パラメーター	タイプ	説明
`body`	`Binding` スキーマ

表3.4 HTTP 応答
HTTP コード	応答本文
200 - OK	`Binding` スキーマ
201 - Created	`Binding` スキーマ
202 - Accepted	`Binding` スキーマ
401 - Unauthorized	空白

3.2.2. /api/v1/namespaces/{namespace}/pods/{name}/binding

表3.5 グローバルパスパラメーター
パラメーター	タイプ	説明
`name`	`string`	バインディングの名前
`namespace`	`string`	チームやプロジェクトなどのオブジェクト名と認証スコープ

表3.6 グローバルクエリーパラメーター
パラメーター	タイプ	説明
`dryRun`	`string`	これが指定されている場合は、変更を永続化してはならないことを示します。dryRun ディレクティブが無効な場合や、認識されない場合は、エラーの応答が返され、その要求に対する処理はこれ以上行われません。有効な値は All で、すべての dryRun ステージが処理されます。
`fieldManager`	`string`	fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。
`fieldValidation`	`string`	fieldValidation は、`ServerSideFieldValidation` 機能ゲートも有効になっている場合に、不明または重複するフィールドを含むリクエスト(POST/PUT/PATCH)内のオブジェクトを処理する方法をサーバーに指示します。有効な値は Ignore です。オブジェクトからサイレントにドロップされた不明なフィールドを無視し、デコーダーが検出した最後の重複フィールドを除くすべてを無視します。これは v1.23 以前のデフォルトの動作であり、`ServerSideFieldValidation` フィーチャーゲートが無効な場合のデフォルトの動作です。警告：オブジェクトから削除された不明なフィールドと、発生した重複フィールドごとに、標準の警告応答ヘッダーを介して警告を送信します。他にエラーがなければ要求は成功し、重複するフィールドの最後のものだけを保持します。これは、`ServerSideFieldValidation` フィーチャーゲートが有効になっている場合のデフォルトです。Strict: オブジェクトから不明なフィールドが削除される場合、または重複するフィールドが存在する場合は、リクエストを BadRequest エラーで失敗します。サーバーから返されるエラーには、検出されたすべての不明な重複フィールドが含まれます。
`pretty`	`string`	true の場合は、出力が整形表示 (Pretty-print) されます。

HTTP メソッド: POST
説明: Pod のバインディングを作成する

表3.7 本文パラメーター
パラメーター	タイプ	説明
`body`	`Binding` スキーマ

表3.8 HTTP 応答
HTTP コード	応答本文
200 - OK	`Binding` スキーマ
201 - Created	`Binding` スキーマ
202 - Accepted	`Binding` スキーマ
401 - Unauthorized	空白

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.