CreateAutoscalingConfig - Container Service for Kubernetes - Alibaba Cloud ドキュメントセンター

自動スケーリングポリシーを作成し、設定されたスケーリングルールに基づいて計算リソースを自動的に追加または削除することで、クラスターのワークロードを処理します。メトリック、しきい値、スケーリング順序、クールダウン期間などを指定できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cs:CreateAutoscalingConfig

create

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

なし

リクエスト構文

POST /cluster/{ClusterId}/autoscale/config/ HTTP/1.1

パスパラメーター

パラメーター	型	必須 / 任意	説明	例
ClusterId	string	必須	クラスター ID。	cdde1f21ae22e483ebcb068a6eb7f****

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
body	object	任意	リクエストボディのパラメーター。
cool_down_duration	string	任意	スケールインイベントのクールダウン期間です。これは、システムがノードがスケールインの対象であると検出してから、スケールイン操作が実行されるまでの時間間隔です。有効値：1～60。単位：分。デフォルト値：10。	10
unneeded_duration	string	任意	安定化期間です。これは、スケールアウトイベント後、スケーラーがスケールイン操作を実行しない期間です。有効値：1～60。単位：分。デフォルト値：10。	10
utilization_threshold	string	任意	スケールインの使用率のしきい値です。これは、要求されたリソースとノード上の割り当て可能な総リソースの比率です。ノードは、その CPU とメモリ使用率の両方がこのしきい値を下回った場合にのみ、スケールインの対象となります。有効値：[0.1, 1]。デフォルト値：0.5 (50%)。	0.5
gpu_utilization_threshold	string	任意	GPU ノードでのスケールインのための GPU 使用率のしきい値です。これは、要求されたリソースとノード上の割り当て可能な総リソースの比率です。 GPU ノードは、その CPU、メモリ、および GPU の使用率がすべてこのしきい値を下回った場合にのみ、スケールインの対象となります。有効値：[0.1, 1]。デフォルト値：0.3 (30%)。	0.3
scan_interval	string	任意	システムがスケーリング条件をチェックする頻度です。有効値：15、30、60、120、180、および 300。単位：秒。デフォルト値：60。	30
scale_down_enabled	boolean	任意	ノードのスケールイン操作を許可するかどうかを指定します。有効値： `true`：スケールイン操作を許可します。 `false`：スケールイン操作を無効にします。列挙値: true : true false : false	true
expander	string	任意	複数のノードプールが利用可能な場合に、スケールアウト用のノードプールを選択するための戦略です。有効値： `least-waste`：デフォルトの戦略です。スケーラーは、スケールアウト後にアイドルリソースが最も少なくなるノードプールを選択します。 `random`：スケーラーは、対象となるノードプールのリストからランダムにノードプールを選択します。 `priority`：スケーラーは、最も優先度の高いノードプールを選択します。`priorities` パラメーターを使用して、各スケーリンググループの優先度を設定する必要があります。列挙値: random : random least-waste : least-waste priority : priority	least-waste
skip_nodes_with_system_pods	boolean	任意	`cluster-autoscaler` が `kube-system` 名前空間の Pod を実行しているノードをスケールインできるかどうかを制御します。この設定は、DaemonSet またはミラー Pod には影響しません。有効値： `true`：これらのノードがスケールインされるのを防ぎます。 `false`：これらのノードのスケールインを許可します。列挙値: true : true false : false	true
skip_nodes_with_local_storage	boolean	任意	`cluster-autoscaler` がローカルストレージ (例：`emptyDir` または `hostPath` ボリューム) を使用する Pod を実行しているノードをスケールインできるかどうかを制御します。有効値： `true`：これらのノードがスケールインされるのを防ぎます。 `false`：これらのノードのスケールインを許可します。列挙値: true : true false : false	false
daemonset_eviction_for_nodes	boolean	任意	`cluster-autoscaler` がスケールインイベント中にノードから DaemonSet Pod のエビクションを実行するかどうかを指定します。有効値： `true`：エビクションを実行します。 `false`：エビクションを実行しません。列挙値: true : true false : false	false
max_graceful_termination_sec	integer	任意	スケールインイベントのノードドレイン中に `cluster-autoscaler` が Pod の終了を待つ最大時間 (秒単位) です。単位：秒。デフォルト値：14400。	14400
min_replica_count	integer	任意	スケールイン操作後も ReplicaSet に残っていなければならない Pod の最小数です。この最小値を下回る場合、ノードはスケールインされません。デフォルト値：0。	0
recycle_node_deletion_enabled	boolean	任意	高速スケーリングモードを使用してノードが正常にスケールインされた後、Kubernetes の Node オブジェクトを削除するかどうかを指定します。詳細については、「スケーリングモード」をご参照ください。デフォルト値：false。有効値： `true`：インスタンスが停止された後、Node オブジェクトは削除されます。この設定は Kubernetes のデータ不整合を引き起こす可能性があるため、推奨されません。 `false`：インスタンスが停止された後、Node オブジェクトは保持されます。列挙値: true : true false : false	false
scale_up_from_zero	boolean	任意	`cluster-autoscaler` がクラスター内に ready ノードがない場合にスケールアウト操作を実行するかどうかを制御します。デフォルト値：true。有効値： `true`：スケールアウト操作が実行されます。 `false`：スケールアウト操作は実行されません。列挙値: true : true false : false	true
scaler_type	string	任意	使用するスケーラーのタイプです。Kubernetes 1.24 以降を実行するクラスターでは、デフォルトは goatscaler です。それ以前のバージョンを実行するクラスターでは、デフォルトは cluster-autoscaler です。有効値： `goatscaler`：高速スケーリング用の独自の開発のスケーラーです。 `cluster-autoscaler`：標準の Kubernetes クラスターオートスケーラーです。列挙値: goatscaler : goatscaler cluster-autoscaler : cluster-autoscaler	goatscaler
priorities	object	任意	スケーリンググループの優先度を設定します。これは、`expander` 戦略が `priority` に設定されている場合に使用されます。ノードプールを作成し、その自動スケーリングを有効にした後、関連するスケーリンググループの優先度を設定できます。詳細については、「ノードの自動スケーリングの有効化」をご参照ください。優先度は 1 から 100 までの正の整数でなければなりません。値が大きいほど優先度が高くなります。
	array	任意	同じ優先度を持つスケーリンググループの ID。
	string	任意	スケーリンググループの ID。	asg-bp1fe63lqz******

レスポンスフィールド

フィールド	型	説明	例
	object
cluster_id	string	クラスター ID。	cc212d04dfe184547bffaa596********
task_id	string	タスク ID。	T-5fd211e924e1d007********
request_id	string	リクエスト ID。	AF8BE105-C32B-1269-9774-5510********

例

成功レスポンス

JSONJSON

{
  "cluster_id": "cc212d04dfe184547bffaa596********",
  "task_id": "T-5fd211e924e1d007********",
  "request_id": "AF8BE105-C32B-1269-9774-5510********"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。