Container Service for Kubernetes:ModifyClusterNodePool

ノードプールの名前。

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

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

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

オートスケーリングを有効にするかどうかを指定します。有効な値：

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

• false：オートスケーリングを無効にします。ACK は、ノードプール内のノード数を `desired_size` の値に調整し、ノード数を変更しません。

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

デフォルト値：`false`。

オートスケーリングのタイプ。このパラメーターは、スケーリングするインスタンスのタイプを指定します。有効な値：

• 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：インスタンスの 1 時間あたりの最大価格を設定します。

• SpotAsPriceGo：システムは現在の市場価格でインスタンスに自動的に入札します。

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

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

• AliyunLinux：Alinux2 イメージ。

• AliyunLinuxSecurity：Alinux2 イメージ UEFI バージョン。

• AliyunLinux3：Alinux3 イメージ。

• AliyunLinux3Arm64：Alinux3 イメージ ARM バージョン。

• AliyunLinux3Security：Alinux3 イメージ UEFI バージョン。

• CentOS：CentOS イメージ。

• Windows：Windows イメージ。

• WindowsCore：WindowsCore イメージ。

• ContainerOS：ContainerOS イメージ。

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

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

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

• cloud_efficiency：Ultra ディスク。

• cloud_ssd：標準 SSD。

• cloud_essd：ESSD。

• cloud_auto：ESSD AutoPL ディスク。

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

デフォルト値：`cloud_efficiency`。

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

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

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

デフォルト値：max{40, ImageId パラメーターで指定されたイメージの ImageSize}。

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

• PL0：中程度の同時 I/O パフォーマンス、安定した読み取り/書き込みレイテンシ。

• PL1：中程度の同時 I/O パフォーマンス、安定した読み取り/書き込みレイテンシ。

• PL2：高い同時 I/O パフォーマンス、安定した読み取り/書き込みレイテンシ。

• PL3：非常に高い同時 I/O パフォーマンス、非常に安定した読み取り/書き込みレイテンシ。

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

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

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

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

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

システムディスクの事前設定された読み取り/書き込み IOPS。

有効値の範囲：0～min{50,000, 1000 × 容量 - ベースライン IOPS}。ベースライン IOPS = min{1,800 + 50 × 容量, 50000}。

このパラメーターは、`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：トラフィック課金。

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

ノードプール内のノードの期待数。

ノードプールが維持すべきノードの総数。クラスターコンポーネントが正常に動作するように、少なくとも 2 つのノードを構成することを推奨します。ノードの期待数を調整することで、ノードプールをスケールアウトまたはスケールインできます。

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

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

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

• COST_OPTIMIZED：vCPU 単価の昇順でインスタンスを作成します。スケーリング設定でスポットインスタンスを作成するように設定されている場合、システムはスポットインスタンスを優先的に作成します。また、`CompensateWithOnDemand` パラメーターを使用して、在庫不足などの理由でスポットインスタンスを作成できない場合に、従量課金インスタンスを自動的に作成するかどうかを指定することもできます。

  説明

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

• BALANCE：指定されたゾーン間で ECS インスタンスを均等に分散します。在庫不足により ECS インスタンスの分散が不均衡になった場合は、`RebalanceInstances` 操作を呼び出してリソースを再分散できます。詳細については、「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：システムが必要な ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成することを許可します。

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

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

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

• AliyunLinux

• CentOS

• Windows

• WindowsCore

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

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

コンテナランタイムの名前。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 アドレス、サフィックスの 3 つの部分で構成されます。

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

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

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

• true：有効。

• false：無効。

デフォルト値：`false`。