10.3. スケール [autoscaling/v1]


説明
スケールは、リソースのスケーリング要求を表します。
タイプ
object

10.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

ScaleSpec は、スケールサブリソースの属性を記述します。

status

object

ScaleStatus は、スケールサブリソースの現在のステータスを表します。

10.3.1.1. .spec

説明
ScaleSpec は、スケールサブリソースの属性を記述します。
タイプ
object
Expand
プロパティータイプ説明

replicas

integer

replicas は、スケーリングされたオブジェクトに必要なインスタンスの数です。

10.3.1.2. .status

説明
ScaleStatus は、スケールサブリソースの現在のステータスを表します。
タイプ
object
必須
  • replicas
Expand
プロパティータイプ説明

replicas

integer

replicas は、スケーリングされたオブジェクトで確認されたインスタンスの実際の数です。

selector

string

selector は、replicas 数と一致する必要がある Pod に対するラベルクエリーです。これはラベルセレクターと同じですが、クライアントによるイントロスペクションを避けるために文字列形式になっています。文字列は、query-param 構文と同じ形式になります。ラベルセレクターの詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

10.3.2. API エンドポイント

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

  • /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

    • GET: 指定されたデプロイメントのスケールを読み取ります
    • PATCH: 指定されたデプロイメントのスケールを部分的に更新します
    • PUT: 指定されたデプロイメントのスケールを置き換えます
  • /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

    • GET: 指定された ReplicaSet のスケールを読み取ります
    • PATCH: 指定された ReplicaSet のスケールを部分的に更新します
    • PUT: 指定された ReplicaSet のスケールを置き換えます
  • /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

    • GET: 指定された StatefulSet のスケールを読み取ります
    • PATCH: 指定された StatefulSet のスケールを部分的に更新します
    • PUT: 指定された StatefulSet のスケールを置き換えます
  • /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

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

10.3.2.1. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

Expand
表10.42 グローバルパスパラメーター
パラメータータイプ説明

name

string

スケールの名前

namespace

string

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

Expand
表10.43 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合は、出力が整形表示 (Pretty-print) されます。

HTTP メソッド
GET
説明
指定されたデプロイメントのスケールを読み取る
Expand
表10.44 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定されたデプロイメントのスケールを部分的に更新します
Expand
表10.45 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。

fieldValidation

string

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

force

boolean

"force" は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。

Expand
表10.46 本文パラメーター
パラメータータイプ説明

body

Patch スキーマ

 
Expand
表10.47 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定されたデプロイメントのスケールを置き換えます
Expand
表10.48 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

fieldValidation

string

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

Expand
表10.49 本文パラメーター
パラメータータイプ説明

body

Scale スキーマ

 
Expand
表10.50 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

10.3.2.2. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

Expand
表10.51 グローバルパスパラメーター
パラメータータイプ説明

name

string

スケールの名前

namespace

string

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

Expand
表10.52 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合は、出力が整形表示 (Pretty-print) されます。

HTTP メソッド
GET
説明
指定された ReplicaSet のスケールを読み取ります
Expand
表10.53 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ReplicaSet のスケールを部分的に更新します
Expand
表10.54 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。

fieldValidation

string

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

force

boolean

"force" は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。

Expand
表10.55 本文パラメーター
パラメータータイプ説明

body

Patch スキーマ

 
Expand
表10.56 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ReplicaSet のスケールを置き換えます
Expand
表10.57 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

fieldValidation

string

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

Expand
表10.58 本文パラメーター
パラメータータイプ説明

body

Scale スキーマ

 
Expand
表10.59 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

10.3.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

Expand
表10.60 グローバルパスパラメーター
パラメータータイプ説明

name

string

スケールの名前

namespace

string

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

Expand
表10.61 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合は、出力が整形表示 (Pretty-print) されます。

HTTP メソッド
GET
説明
指定された StatefulSet のスケールを読み取ります
Expand
表10.62 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された StatefulSet のスケールを部分的に更新します
Expand
表10.63 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。

fieldValidation

string

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

force

boolean

"force" は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。

Expand
表10.64 本文パラメーター
パラメータータイプ説明

body

Patch スキーマ

 
Expand
表10.65 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された StatefulSet のスケールを置き換えます
Expand
表10.66 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

fieldValidation

string

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

Expand
表10.67 本文パラメーター
パラメータータイプ説明

body

Scale スキーマ

 
Expand
表10.68 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

10.3.2.4. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

Expand
表10.69 グローバルパスパラメーター
パラメータータイプ説明

name

string

スケールの名前

namespace

string

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

Expand
表10.70 グローバルクエリーパラメーター
パラメータータイプ説明

pretty

string

'true' の場合は、出力が整形表示 (Pretty-print) されます。

HTTP メソッド
GET
説明
指定された ReplicationController のスケールを読み取ります
Expand
表10.71 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PATCH
説明
指定された ReplicationController のスケールを部分的に更新します
Expand
表10.72 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。このフィールドは、apply 要求 (application/apply-patch) の場合は必須ですが、apply 以外のパッチタイプ (JsonPatch、MergePatch、StrategicMergePatch) の場合は任意です。

fieldValidation

string

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

force

boolean

"force" は、Apply 要求を強制します。これは、ユーザーが他の人が所有する競合するフィールドを再取得することを意味します。非適用パッチ要求の場合は、強制フラグを設定解除する必要があります。

Expand
表10.73 本文パラメーター
パラメータータイプ説明

body

Patch スキーマ

 
Expand
表10.74 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

HTTP メソッド
PUT
説明
指定された ReplicationController のスケールを置き換えます
Expand
表10.75 クエリーパラメーター
パラメータータイプ説明

dryRun

string

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

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

fieldValidation

string

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

Expand
表10.76 本文パラメーター
パラメータータイプ説明

body

Scale スキーマ

 
Expand
表10.77 HTTP 応答
HTTP コード応答本文

200 - OK

Scale スキーマ

201 - Created

Scale スキーマ

401 - Unauthorized

空白

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat