Container Service for Kubernetes:ModifyClusterNodePool

ノードプールの名前。

命名規則: 名前は 1～63 文字で、数字、漢字、英字、ハイフン (-) を含めることができます。ハイフン (-) で始めることはできません。

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

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

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

• true: ノードプールの Auto scaling を有効にします。クラスターの容量計画がアプリケーション Pod のスケジューリング要件を満たせない場合、ACK は設定された最小値および最大値のインスタンス数に基づいてノードリソースを自動的にスケーリングします。バージョン 1.24 以降のクラスターでは、デフォルトで即時弾力性が使用されます。1.24 より前のバージョンのクラスターでは、デフォルトで Auto scaling が使用されます。詳細については、「ノードのスケーリング」(~~2746785~~) を参照してください。

• 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。

ノード自己修復のための ECS 障害検出を有効にするかどうかを指定します。

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

• 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: システムが現在の市場価格で自動的に入札します。

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

オペレーティングシステムディストリビューションタイプ。ノードのオペレーティングシステムを指定するには、このフィールドを使用します。有効な値:

• AliyunLinux: Alinux 2 イメージ。

• AliyunLinuxSecurity: Alinux 2 UEFI イメージ。

• AliyunLinux3: Alinux 3 イメージ。

• AliyunLinux3Arm64: Alinux 3 ARM イメージ。

• AliyunLinux3Security: Alinux 3 UEFI イメージ。

• CentOS: CentOS イメージ。

• Windows: Windows イメージ。

• WindowsCore: WindowsCore イメージ。

• ContainerOS: コンテナ最適化イメージ。

• AliyunLinux3ContainerOptimized: Alinux 3 コンテナ最適化イメージ。

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

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

• cloud_efficiency: ウルトラクラウドディスク。

• cloud_ssd: 標準 SSD。

• cloud_essd: ESSD (エンタープライズ SSD)。

• cloud_auto: ESSD AutoPL クラウドディスク。

• cloud_essd_entry: ESSD Entry クラウドディスク。

デフォルト値: cloud_efficiency。

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

有効な値: [20,2048]。

値は max{20, ImageSize} 以上である必要があります。

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

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

• PL0: 中程度の最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが比較的安定しています。

• PL1: 中程度の最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが比較的安定しています。

• PL2: 高い最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが安定しています。

• PL3: 超高い最大同時 I/O パフォーマンスで、読み取り/書き込みレイテンシが非常に安定しています。

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

• true: 暗号化。

• false: 暗号化なし。

システムクラウドディスクで使用される KMS キーの ID。

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

ノードシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。

有効な値: 0 ～ min{50,000, 1000 × capacity - baseline performance}。ベースラインパフォーマンス = min{1,800 + 50 × capacity, 50000}。

このパラメーターは system_disk_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」(~~368372~~) を参照してください。

ノードシステムクラウドディスクのバースト (パフォーマンスバースト) を有効にするかどうかを指定します。有効な値:

• true: 有効。有効にすると、変動するワークロードによる突然のデータ読み取り/書き込み圧力時に、クラウドディスクが一時的にパフォーマンスを向上させ、ワークロードが安定するまで維持します。

• false: 無効。

このパラメーターは system_disk_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」(~~368372~~) を参照してください。

キーペアの名前。このパラメーターと login_password は相互排他です。マネージドノードプールでは、key_pair のみがサポートされています。

SSH ログインパスワード。このパラメーターと key_pair は相互排他です。パスワードは 8～30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

パブリック IP アドレスの課金タイプ。有効な値:

• PayByBandwidth: 帯域幅課金。

• PayByTraffic: データ転送量課金。

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

ノードプールの希望ノード数。

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

ノードを作成する必要がない場合は、このパラメーターを 0 に設定し、後でノード数を手動で調整してください。

スケーリンググループ内の ECS インスタンスに対するマルチゾーンスケーリングポリシー。有効な値:

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

• COST_OPTIMIZED: vCPU の単位価格が低い順にインスタンスの作成を試みます。スケーリング設定でスポット課金方法の複数のインスタンスタイプが指定されている場合、スポットインスタンスが優先的に作成されます。CompensateWithOnDemand パラメーターを使用して、在庫不足によりスポットインスタンスを作成できない場合に、従量課金インスタンスを自動的に作成するかどうかを指定できます。

  説明

  COST_OPTIMIZED は、スケーリング設定で複数のインスタンスタイプが指定されているか、スポットインスタンスが使用されている場合にのみ効果を持ちます。

• BALANCE: スケーリンググループで指定されたゾーン全体に ECS インスタンスを均等に分散します。在庫不足によりゾーンのバランスが崩れた場合、RebalanceInstances API オペレーションを呼び出してリソースをリバランスできます。詳細については、「RebalanceInstances」(~~71516~~) を参照してください。

デフォルト値: PRIORITY。

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

• release: 標準モード。リソース使用量に基づいて ECS インスタンスを作成およびリリースすることでスケーリングします。

• recycle: 高速モード。インスタンスの作成、停止、開始を行うことでスケーリングし、後続のスケーリング操作の速度を向上させます。(停止中のインスタンスにはコンピューティングリソースの料金はかかりませんが、ローカルディスクを持つインスタンスを除き、ストレージ料金は引き続き発生します。)

スケーリンググループに必要な従量課金インスタンスの最小値。有効な値: [0,1000]。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが優先的に作成されます。

最小従量課金インスタンス数 (on_demand_base_capacity) を超えるインスタンスにおける従量課金インスタンスの割合。有効な値: [0

利用可能なインスタンスタイプの数。スケーリンググループは、複数の最も低コストのインスタンスタイプのスポットインスタンスをバランスよく作成します。有効な値: [1,10]。

スポットインスタンスの補充を有効にするかどうかを指定します。有効にすると、システムからスポットインスタンスが回収されるという通知があった場合、スケーリンググループは新しいインスタンスを作成して、回収されるスポットインスタンスを置き換えようとします。有効な値:

• true: スポットインスタンスの補充を有効にします。

• false: スポットインスタンスの補充を無効にします。

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

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

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

This parameter is deprecated. Use the image_type parameter instead.

The operating system platform. Valid values:

• AliyunLinux

• CentOS

• Windows

• WindowsCore

The deployment set to which the ECS instances created by the node pool belong. This setting takes effect only on new nodes. The deployment set of existing nodes is not changed.

The snapshot policy for the system cloud disk.

The container runtime name. ACK supports the following three container runtimes:

• containerd: recommended. Supports all cluster versions.

• Sandboxed-Container.runv: sandboxed container that provides higher isolation. Supports cluster versions 1.31 and earlier.

• docker: no longer maintained. Supports cluster versions 1.22 and earlier.

Default value: containerd.

The container runtime version.

The node CPU management policy. The following two policies are supported for cluster versions 1.12.6 and later:

• static: allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.

• none: enables the existing default CPU affinity scheme.

Default value: none.

Specifies whether the nodes added during scale-out are unschedulable.

• true: Unschedulable.

• false: Schedulable.

The instance user data. After the node joins the cluster, the specified user data script is executed. For more information, see User data scripts.

Specifies whether to install the CloudMonitor agent on ECS nodes. After installation, you can view monitoring information of the created ECS instances in the CloudMonitor console. We recommend that you enable this feature. Valid values:

• true: Installs the CloudMonitor agent on ECS nodes.

• false: Does not install the CloudMonitor agent on ECS nodes.

Default value: false.

The pre-instance user data. Before the node joins the cluster, the specified pre-user data script is executed. For more information, see User data scripts.

The custom node name parameter. A node name consists of three parts: prefix + node IP + suffix.

Both the prefix and suffix can consist of one or more parts separated by ".". Each part can contain lowercase letters, digits, and hyphens (-). The node name must start and end with a lowercase letter or digit. The node IP is the full private IP address of the node.

The parameter contains four parts separated by commas. For example, if you pass in the string "customized,aliyun,ip,com" (where "customized" and "ip" are fixed strings, "aliyun" is the prefix, and "com" is the suffix), the node name is: aliyun.192.168.xxx.xxx.com.

Specifies whether to enable confidential computing for the cluster. Valid values:

• true: Enabled.

• false: Disabled.

Default value: false.

Specifies whether to enable automatic addition for the Lingjun node pool. (Not effective)