Container Service for Kubernetes:ModifyClusterNodePool

ノードプールの名前。

名前は 1～63 文字で、数字、文字、ハイフン (-) を使用できます。ハイフン (-) で始めることはできません。

ノードプールが属するリソースグループの ID。ノードプールで作成されたインスタンスは、このリソースグループに属します。

1 つのリソースは 1 つのリソースグループにのみ属することができます。必要に応じて、リソースグループをプロジェクト、アプリケーション、または組織にマッピングできます。

auto scaling を有効にするかどうかを指定します。有効な値：

• true：ノードプールの auto scaling を有効にします。クラスターリソースが不足している場合、ACK は指定されたインスタンスの最小数と最大数に基づいてノードを自動的にスケーリングします。Kubernetes バージョン 1.24 以降のクラスターでは、デフォルトで瞬時弾力性が有効になります。Kubernetes バージョン 1.24 より前のクラスターでは、デフォルトでノードの自動スケーリングが有効になります。詳細については、「ノードのスケーリング」をご参照ください。

• false：auto scaling を無効にします。ACK は、ノードプール内のノード数を期待されるノード数に調整し、ノード数を変更しません。

このパラメーターを false に設定した場合、auto_scaling 内の他のパラメーターは有効になりません。

デフォルト値：false。

auto scaling のタイプ。スケーリングはインスタンスタイプに基づいて実行されます。有効な値：

• cpu：通常のインスタンス。

• gpu：GPU コンピューティング型インスタンス。

• gpushare：共有 GPU コンピューティング型インスタンス。

• spot：スポットインスタンス。

デフォルト値：cpu。

ノードプールに作成できるインスタンスの最大数。この値には既存のインスタンスは含まれません。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

有効値の範囲：[min_instances, 2000]。デフォルト値：0。

ノードプールに作成できるインスタンスの最小数。この値には既存のインスタンスは含まれません。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

有効値の範囲：[0, max_instances]。デフォルト値：0。

[このパラメーターは非推奨です] このパラメーターは非推奨です。代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

• true：EIP を関連付けます。

• false：EIP を関連付けません。

デフォルト値：false。

[このパラメーターは非推奨です] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

EIP の課金方法。有効な値：

• PayByBandwidth：帯域幅課金。

• PayByTraffic：トラフィック課金。

デフォルト値：PayByBandwidth。

[このパラメーターは非推奨です] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。 EIP のピーク帯域幅。

有効値の範囲：[1, 100]。単位：Mbit/s。

マネージドノードプール機能を有効にするかどうかを指定します。有効な値：

• true：マネージドノードプール機能を有効にします。

• false：マネージドノードプール機能を無効にします。このセクションの他のパラメーターは、enable が true に設定されている場合にのみ有効になります。

デフォルト値：false。

ノードの自動修復を有効にするかどうかを指定します。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

• true：自動修復を有効にします。

• false：自動修復を無効にします。

デフォルト値：true

CVE 脆弱性の自動修復を有効にするかどうかを指定します。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

• true：CVE の自動修復を有効にします。

• false：CVE の自動修復を無効にします。

デフォルト値：true。

ノードの自動アップグレードを有効にするかどうかを指定します。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

• true：自動アップグレードを有効にします。

• false：自動アップグレードを無効にします。

デフォルト値：true

ノードプール内のノードの課金方法。有効な値：

• PrePaid：サブスクリプション

• PostPaid：従量課金

デフォルト値：PostPaid。

ノードプール内のノードのサブスクリプション期間。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ有効になり、必須です。

• period_unit が Week に設定されている場合、period の有効な値は 1、2、3、4 です。

• period_unit が Month に設定されている場合、period の有効な値は 1、2、3、4、5、6、7、8、9、12、24、36、48、60 です。

ノードプール内のノードの課金サイクル。このパラメーターは、instance_charge_type が PrePaid に設定されている場合に必須です。

• Month：課金サイクルは月単位です。

• Week：課金サイクルは週単位です。

デフォルト値：Month。

ノードの自動更新を有効にするかどうかを指定します。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ有効になります。有効な値：

• true：自動更新を有効にします。

• false：自動更新を無効にします。

デフォルト値：false。

自動更新期間。有効な値：

• PeriodUnit が Week の場合：1、2、3。

• PeriodUnit が Month の場合：1、2、3、6、12、24、36、48、60。

デフォルト値：1。

スポットインスタンスの入札ポリシー。有効な値：

• NoSpot：インスタンスはスポットインスタンスではありません。

• SpotWithPriceLimit：スポットインスタンスの最高入札価格を設定します。

• SpotAsPriceGo：システムは市場価格で自動的に入札します。

詳細については、「スポットインスタンス」をご参照ください。

OS のディストリビューション。このパラメーターを使用してノードの OS を指定することを推奨します。有効な値：

• AliyunLinux：Alinux2 イメージ。

• AliyunLinuxSecurity：Alinux2 UEFI イメージ。

• AliyunLinux3：Alinux3 イメージ。

• AliyunLinux3Arm64：Alinux3 ARM イメージ。

• AliyunLinux3Security：Alinux3 UEFI イメージ。

• CentOS：CentOS イメージ。

• Windows：Windows イメージ。

• WindowsCore：WindowsCore イメージ。

• ContainerOS：Container-Optimized OS。

• AliyunLinux3ContainerOptimized：Alinux3 コンテナ最適化イメージ。

カスタムイメージの ID。DescribeKubernetesVersionMetadata 操作を呼び出して、システムでサポートされているイメージをクエリできます。デフォルトでは、最新のシステムイメージが使用されます。

ノードのシステムディスクのタイプ。有効な値：

• cloud_efficiency：Ultra ディスク。

• cloud_ssd：標準 SSD。

• cloud_essd：ESSD (Enhanced SSD)。

• cloud_auto：ESSD AutoPL ディスク。

• cloud_essd_entry：ESSD エントリーディスク。

デフォルト値：cloud_efficiency。

ノードのシステムディスクのサイズ。単位：GiB。

有効値の範囲：[20, 2048]。

このパラメーターの値は、max{20, ImageSize} 以上である必要があります。

デフォルト値：max{40, ImageId パラメーターに対応するイメージのサイズ}。

ノードのシステムディスクのパフォーマンスレベル。このパラメーターは ESSD にのみ有効です。ディスクのパフォーマンスレベルはディスクサイズに関連しています。詳細については、「ESSD」をご参照ください。

• PL0：ESSD は中程度の IOPS と安定した読み書きレイテンシを持ちます。

• PL1：ESSD は中程度の IOPS と安定した読み書きレイテンシを持ちます。

• PL2：ESSD は高い IOPS と安定した読み書きレイテンシを持ちます。

• PL3：ESSD は超高 IOPS と超安定した読み書きレイテンシを持ちます。

システムディスクを暗号化するかどうかを指定します。有効な値：

• true：システムディスクを暗号化します。

• false：システムディスクを暗号化しません。

システムディスクの暗号化に使用される KMS キーの ID。

システムディスクの暗号化に使用される暗号化アルゴリズム。有効な値：aes-256。

ノードのシステムディスクのプロビジョニングされた読み書き IOPS。

有効な値：0 から min{50,000, 1,000 × 容量 - ベースライン IOPS}。ベースライン IOPS = min{1,800 + 50 × 容量, 50,000}。

このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみ設定できます。詳細については、「ESSD AutoPL ディスク」をご参照ください。

ノードのシステムディスクのバースト機能を有効にするかどうかを指定します。有効な値：

• true：バースト機能を有効にします。この機能を有効にすると、ビジネストラフィックが変動したときに、ビジネス要件を満たすためにディスクのパフォーマンスが一時的に向上します。

• false：バースト機能を無効にします。

このパラメーターは、system_disk_category が cloud_auto に設定されている場合にのみ設定できます。詳細については、「ESSD AutoPL ディスク」をご参照ください。

キーペアの名前。key_pair と login_password のいずれかを設定する必要があります。ノードプールがマネージドノードプールの場合、key_pair のみ設定できます。

SSH ログインパスワード。key_pair と login_password のいずれかを設定する必要があります。パスワードは 8～30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。

パブリック IP アドレスの課金方法。有効な値：

• PayByBandwidth：帯域幅課金。

• PayByTraffic：トラフィック課金。

ノードの最大パブリックアウトバウンド帯域幅。単位：Mbit/s。有効値の範囲：[1, 100]。

ノードプール内の期待されるノード数。

ノードプールに期待されるノードの総数。クラスターコンポーネントが期待どおりに実行されるように、このパラメーターを 2 以上の値に設定することを推奨します。このパラメーターを調整することで、ノードプールをスケーリングできます。

ノードを作成したくない場合は、このパラメーターを 0 に設定します。後でノード数を手動で調整できます。

マルチゾーンスケーリンググループ内の ECS インスタンスのスケーリングポリシー。有効な値：

• PRIORITY：指定した vSwitch の優先度 (VSwitchIds.N) に基づいてインスタンスをスケーリングします。優先度の高い vSwitch が存在するゾーンでインスタンスを作成できない場合、システムは次に優先度の高い vSwitch が存在するゾーンでインスタンスを自動的に作成します。

• COST_OPTIMIZED：最も低い vCPU 価格を提供するゾーンでインスタンスを作成しようとします。スケーリング設定がスポットインスタンスの課金方法で複数のインスタンスタイプを作成するように設定されている場合、システムは対応するスポットインスタンスの作成を優先します。CompensateWithOnDemand パラメーターを使用して、在庫切れなどの理由でスポットインスタンスを作成できない場合に、従量課金インスタンスを自動的に作成するかどうかを指定できます。

  説明

  COST_OPTIMIZED ポリシーは、スケーリング設定で複数のインスタンスタイプが指定されている場合、またはスポットインスタンスが選択されている場合にのみ有効になります。

• BALANCE：スケーリンググループに指定されたゾーンに ECS インスタンスを均等に分散します。在庫切れなどの理由で ECS インスタンスの分散が不均衡になった場合は、RebalanceInstances 操作を呼び出してリソースを再分散できます。

デフォルト値：PRIORITY。

スケーリンググループのスケーリングモード。有効な値：

• release：標準モード。システムはリソース使用量に基づいて ECS インスタンスを作成およびリリースしてリソースをスケーリングします。

• recycle：高速モード。システムは ECS インスタンスを作成、停止、開始してリソースをスケーリングします。これにより、スケーリング速度が向上します。インスタンスが停止されると、その計算リソースは課金されませんが、ストレージリソースは課金されます。これはローカルディスクを持つインスタンスには適用されません。

スケーリンググループに含まれる必要がある従量課金インスタンスの最小数。有効値の範囲：[0, 1000]。従量課金インスタンスの数がこの値より少ない場合、システムは従量課金インスタンスの作成を優先します。

on_demand_base_capacity で指定された従量課金インスタンスの最小数を超えるインスタンスのうち、従量課金インスタンスの割合。有効値の範囲：[0, 100]。

利用可能なインスタンスタイプの数。スケーリンググループは、最も低コストの複数のインスタンスタイプのスポットインスタンスを均等に作成します。有効値の範囲：[1, 10]。

インスタンスの置き換え機能を有効にするかどうかを指定します。この機能を有効にすると、スケーリンググループは、回収されようとしているスポットインスタンスを置き換えるために新しいインスタンスを作成しようとします。有効な値：

• true：インスタンスの置き換え機能を有効にします。

• false：インスタンスの置き換え機能を無効にします。

multi_az_policy が COST_OPTIMIZED に設定されている場合、価格や在庫などの理由でスポットインスタンスを作成できない場合に、ECS インスタンスの数に関する要件を満たすためにシステムが自動的に従量課金インスタンスを作成することを許可するかどうかを指定します。有効な値：

• true：システムが自動的に従量課金インスタンスを作成することを許可します。

• false：システムが自動的に従量課金インスタンスを作成することを許可しません。

[このパラメーターは非推奨です] 代わりに image_type パラメーターを使用してください。

OS プラットフォーム。有効な値：

• AliyunLinux

• CentOS

• Windows

• WindowsCore

ノードプール内の ECS インスタンスが属するデプロイメントセット。このパラメーターは増分ノードにのみ有効です。既存のノードのデプロイメントセットは変更されません。

システムディスクのスナップショットポリシー。

コンテナランタイムの名前。ACK は次のコンテナランタイムをサポートしています。

• containerd：推奨。このランタイムはすべてのクラスターバージョンでサポートされています。

• Sandboxed-Container.runv：より高い隔離性を提供するサンドボックスコンテナ。このランタイムは Kubernetes 1.31 以前のクラスターでサポートされています。

• docker：このランタイムはメンテナンスが終了しており、Kubernetes 1.22 以前のクラスターでのみサポートされています。

デフォルト値：containerd。

コンテナランタイムのバージョン。

ノードの CPU 管理ポリシー。クラスターの Kubernetes バージョンが 1.12.6 以降の場合、次のポリシーがサポートされます：

• static：ノード上の特定のリソース特性を持つ Pod に、強化された CPU アフィニティと排他性を付与できます。

• none：デフォルトの CPU アフィニティスキームが使用されることを示します。

デフォルト値：none。

スケールアウトされたノードがスケジュール不可かどうかを指定します。

• true：ノードはスケジュール不可です。

• false：ノードはスケジュール可能です。

インスタンスのユーザーデータ。ノードがクラスターに追加された後、カスタムデータスクリプトが実行されます。詳細については、「ユーザーデータスクリプト」をご参照ください。

ECS ノードに Cloud Monitor をインストールするかどうかを指定します。Cloud Monitor をインストールすると、Cloud Monitor コンソールで作成された ECS インスタンスのモニタリング情報を表示できます。この機能を有効にすることを推奨します。有効な値：

• true：ECS ノードに Cloud Monitor をインストールします。

• false：ECS ノードに Cloud Monitor をインストールしません。

デフォルト値：false。

インスタンスの事前カスタムデータ。ノードがクラスターに追加される前に、事前カスタムデータスクリプトが実行されます。詳細については、「ユーザーデータスクリプト」をご参照ください。

カスタムノード名パラメーター。ノード名は、プレフィックス、ノードの IP アドレス、およびサフィックスで構成されます

プレフィックスとサフィックスは、ピリオド (.) で区切られた 1 つ以上の部分で構成できます。各部分は、小文字、数字、ハイフン (-) を含むことができます。ノード名は、小文字または数字で開始および終了する必要があります。ノード IP アドレスは、ノードの完全なプライベート IP アドレスです。

このパラメーターは、コンマ (,) で区切られた 4 つの部分で構成されます。例：「customized,aliyun,ip,com」という文字列 (「customized」と「ip」は固定文字列、aliyun はプレフィックス、com はサフィックス) を渡した場合、ノード名は aliyun.192.168.xxx.xxx.com になります。

機密計算用 Kubernetes クラスターを有効にするかどうかを指定します。有効な値：

• true：クラスターを有効にします。

• false：クラスターを無効にします。

デフォルト値：false。