クラスター API

OpenShift Container Platform 4.20

クラスター API のリファレンスガイド

Red Hat OpenShift Documentation Team

法律上の通知

概要

このドキュメントでは、OpenShift Container Platform クラスター API オブジェクトとその詳細な仕様を説明します。

第1章クラスター API
リンクのコピー

1.1. IPAddress [ipam.cluster.x-k8s.io/v1beta1]
リンクのコピー

説明: IPAddress は、ipaddress API のスキーマです。
型: object

1.2. IPAddressClaim [ipam.cluster.x-k8s.io/v1beta1]
リンクのコピー

説明: IPAddressClaim は、ipaddressclaim API のスキーマです。
型: object

第2章 IPAddress [ipam.cluster.x-k8s.io/v1beta1]
リンクのコピー

説明: IPAddress は、ipaddress API のスキーマです。
型: object

2.1. 仕様
リンクのコピー

Expand

プロパティー	型	説明
`apiVersion`	`string`	apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。
`kind`	`string`	kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。
`metadata`	`ObjectMeta`	標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。
`spec`	`object`	spec は IPAddress の望ましい状態です。

2.1.1. .spec
リンクのコピー

説明

spec は IPAddress の望ましい状態です。

型

object

必須

address
claimRef
poolRef
prefix

Expand

プロパティー	型	説明
`address`	`string`	address は IP アドレスです。
`claimRef`	`object`	claimRef は、この IPAddress が作成されたクレームへの参照です。
`gateway`	`string`	gateway は、アドレスの送信元ネットワークのネットワークゲートウェイです。
`poolRef`	`object`	poolRef は、この IP アドレスが作成されたプールへの参照です。
`prefix`	`integer`	prefix はアドレスの接頭辞です。

2.1.2. .spec.claimRef
リンクのコピー

説明: claimRef は、この IPAddress が作成されたクレームへの参照です。
型: object

Expand

プロパティー	型	説明
`name`	`string`	参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

2.1.3. .spec.poolRef
リンクのコピー

説明

poolRef は、この IP アドレスが作成されたプールへの参照です。

型

object

必須

kind
name

Expand

プロパティー	型	説明
`apiGroup`	`string`	APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。
`kind`	`string`	kind は参照されているリソースのタイプです。
`name`	`string`	name は、参照されているリソースの名前です。

2.2. API エンドポイント
リンクのコピー

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

/apis/ipam.cluster.x-k8s.io/v1beta1/ipaddresses
- GET: IPAddress の種類のオブジェクトをリスト表示する
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses
- DELETE: IPAddress のコレクションを削除する
- GET: IPAddress の種類のオブジェクトをリスト表示する
- POST: IPAddress を作成する
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses/{name}
- DELETE: IPAddress を削除する
- GET: 指定された IPAddress を読み取る
- PATCH: 指定された IPAddress を部分的に更新する
- PUT: 指定された IPAddress を置き換える

2.2.1. /apis/ipam.cluster.x-k8s.io/v1beta1/ipaddresses
リンクのコピー

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

Expand

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

2.2.2. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses
リンクのコピー

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

Expand

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

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

Expand

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

HTTP メソッド: POST
説明: IPAddress を作成します。

Expand

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

Expand

表2.5 本文パラメーター
パラメーター	型	説明
`body`	`IPAddress` スキーマ

Expand

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

2.2.3. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddresses/{name}
リンクのコピー

Expand

表2.7 グローバルパスパラメーター
パラメーター	型	説明
`name`	`string`	IPAddress の名前

HTTP メソッド: DELETE
説明: IPAddress を削除します。

Expand

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

Expand

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

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

Expand

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

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

Expand

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

Expand

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

HTTP メソッド: PUT
説明: 指定された IPAddress を置き換える

Expand

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

Expand

表2.14 本文パラメーター
パラメーター	型	説明
`body`	`IPAddress` スキーマ

Expand

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

第3章 IPAddressClaim [ipam.cluster.x-k8s.io/v1beta1]
リンクのコピー

説明: IPAddressClaim は、ipaddressclaim API のスキーマです。
型: object

3.1. 仕様
リンクのコピー

Expand

プロパティー	型	説明
`apiVersion`	`string`	apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。
`kind`	`string`	kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。
`metadata`	`ObjectMeta`	標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。
`spec`	`object`	spec は IPAddressClaim の適切な状態です。
`status`	`object`	status は、IPAddressClaim の現在観測されている状態です。

3.1.1. .spec
リンクのコピー

説明

spec は IPAddressClaim の適切な状態です。

型

object

必須

poolRef

Expand

プロパティー	型	説明
`clusterName`	`string`	clusterName は、このオブジェクトが属するクラスターの名前です。
`poolRef`	`object`	poolRef は、IP アドレスを作成するプールへの参照です。

3.1.2. .spec.poolRef
リンクのコピー

説明

poolRef は、IP アドレスを作成するプールへの参照です。

型

object

必須

kind
name

Expand

プロパティー	型	説明
`apiGroup`	`string`	APIGroup は参照されているリソースのグループです。APIGroup が指定されていない場合は、指定の Kind をコア API グループに設定する必要があります。他のサードパーティータイプには、APIGroup が必要です。
`kind`	`string`	kind は参照されているリソースのタイプです。
`name`	`string`	name は、参照されているリソースの名前です。

3.1.3. .status
リンクのコピー

説明: status は、IPAddressClaim の現在観測されている状態です。
型: object

Expand

プロパティー	型	説明
`addressRef`	`object`	addressRef は、このクレームに対して作成されたアドレスへの参照です。
`conditions`	`array`	conditions は、IPAddressClaim の現在の状態を要約します。
`conditions[]`	`object`	条件は、Cluster API リソースの動作状態の観察を定義します。
`v1beta2`	`object`	v1beta2 は、IPAddressClaim のステータスに追加または変更されるすべてのフィールドを V1Beta2 バージョンでグループ化します。

3.1.4. .status.addressRef
リンクのコピー

説明: addressRef は、このクレームに対して作成されたアドレスへの参照です。
型: object

Expand

プロパティー	型	説明
`name`	`string`	参照先の名前。このフィールドは実質的には必須ですが、下位互換性のため空でもかまいません。ここで空の値を持つこの型のインスタンスは、ほぼ間違いなく間違っています。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

3.1.5. .status.conditions
リンクのコピー

説明: conditions は、IPAddressClaim の現在の状態を要約します。
型: array

3.1.6. .status.conditions[]
リンクのコピー

説明

条件は、Cluster API リソースの動作状態の観察を定義します。

型

object

必須

lastTransitionTime
status
type

Expand

プロパティー	型	説明
`lastTransitionTime`	`string`	lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。
`message`	`string`	message は、遷移の詳細を示す人が判読できるメッセージです。このフィールドは空の場合があります。
`reason`	`string`	reason は、最後の遷移の理由です (CamelCase)。特定の API は、このフィールドが保証された API と見なされるかどうかを選択できます。このフィールドは空の場合があります。
`severity`	`string`	severity は理由コードの明示的な分類を提供するため、ユーザーまたはマシンは現在の状況を即座に理解し、それに応じて行動できます。Severity フィールドは、Status=False の場合にのみ設定する必要があります。
`status`	`string`	条件のステータス、True、False、Unknown のいずれか。
`type`	`string`	CamelCase または foo.example.com/CamelCase の条件のタイプ。多くの.condition.type 値は、Available などのリソース全体で一貫していますが、任意の条件が役立つ可能性があるため (.node.status.conditions を参照)、競合を解消する機能が重要です。

3.1.7. .status.v1beta2
リンクのコピー

説明: v1beta2 は、IPAddressClaim のステータスに追加または変更されるすべてのフィールドを V1Beta2 バージョンでグループ化します。
型: object

Expand

プロパティー	型	説明
`conditions`	`array`	conditions は、IPAddressClaim の現在の状態の観察結果を表します。
`conditions[]`	`object`	condition には、この API Resource の現在の状態のある側面の詳細が含まれます。

3.1.8. .status.v1beta2.conditions
リンクのコピー

説明: conditions は、IPAddressClaim の現在の状態の観察結果を表します。
型: array

3.1.9. .status.v1beta2.conditions[]
リンクのコピー

説明

condition には、この API Resource の現在の状態のある側面の詳細が含まれます。

型

object

必須

lastTransitionTime
message
reason
status
type

Expand

プロパティー	型	説明
`lastTransitionTime`	`string`	lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。
`message`	`string`	message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。
`observedGeneration`	`integer`	observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。
`reason`	`string`	reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。
`status`	`string`	条件のステータス、True、False、Unknown のいずれか。
`type`	`string`	CamelCase または foo.example.com/CamelCase の条件のタイプ。

3.2. API エンドポイント
リンクのコピー

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

/apis/ipam.cluster.x-k8s.io/v1beta1/ipaddressclaims
- GET: IPAddressClaim の種類のオブジェクトをリスト表示する
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims
- DELETE: IPAddressClaim のコレクションを削除する
- GET: IPAddressClaim の種類のオブジェクトをリスト表示する
- POST: IPAddressClaim を作成する
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}
- DELETE: IPAddressClaim を削除する
- GET: 指定された IPAddressClaim を読み取る
- PATCH: 指定された IPAddressClaim を部分的に更新する
- PUT: 指定された IPAddressClaim を置き換える
/apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}/status
- GET: 指定された IPAddressClaim のステータスを読み取る
- PATCH: 指定された IPAddressClaim のステータスを部分的に更新する
- PUT: 指定された IPAddressClaim のステータスを置き換える

3.2.1. /apis/ipam.cluster.x-k8s.io/v1beta1/ipaddressclaims
リンクのコピー

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

Expand

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

3.2.2. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims
リンクのコピー

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

Expand

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

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

Expand

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

HTTP メソッド: POST
説明: IPAddressClaim を作成します。

Expand

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

Expand

表3.5 本文パラメーター
パラメーター	型	説明
`body`	`IPAddressClaim` スキーマ

Expand

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

3.2.3. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}
リンクのコピー

Expand

表3.7 グローバルパスパラメーター
パラメーター	型	説明
`name`	`string`	IPAddressClaim の名前

HTTP メソッド: DELETE
説明: IPAddressClaim を削除します。

Expand

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

Expand

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

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

Expand

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

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

Expand

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

Expand

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

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

Expand

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

Expand

表3.14 本文パラメーター
パラメーター	型	説明
`body`	`IPAddressClaim` スキーマ

Expand

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

3.2.4. /apis/ipam.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/ipaddressclaims/{name}/status
リンクのコピー

Expand

表3.16 グローバルパスパラメーター
パラメーター	型	説明
`name`	`string`	IPAddressClaim の名前

HTTP メソッド: GET
説明: 指定された IPAddressClaim のステータスを読み取る

Expand

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

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

Expand

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

Expand

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

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

Expand

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

Expand

表3.21 本文パラメーター
パラメーター	型	説明
`body`	`IPAddressClaim` スキーマ

Expand

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

Legal Notice
リンクのコピー

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

クラスター API