Container Service for Kubernetes:CreateClusterNodePool

ノードプール名。

ノードプールタイプ。有効な値:

• ess: 標準ノードプール（マネージドおよび auto scaling 特徴を含む）。

• edge: エッジノードプール。

• lingjun: Lingjun ノードプール。

• hybrid: ハイブリッドクラウドノードプール。

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

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

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

• true: ノードプールの auto scaling を有効にします。クラスター容量が Pod のスケジューリング要件を満たせない場合、ACK は構成された最小値および最大値のインスタンス数に基づいてノードリソースを自動的にスケーリングします。バージョン 1.24 以降のクラスターではデフォルトでインスタントノードスケーリングが有効になります。バージョン 1.24 より前のクラスターではデフォルトでノード auto scaling が有効になります。詳細については、ノードスケーリングを参照してください。

• false: auto scaling を無効にします。ACK は構成された希望ノード数に基づいてノードプール内のノード数を調整し、常にノード数を希望数に維持します。

このパラメーターが false に設定されている場合、auto_scaling 内の他の構成パラメーターは効果がありません。

デフォルト値: false。

auto scaling のスケーリングインスタンスタイプ。enable=true の場合にのみ効果があります。有効な値:

• 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 を使用してください。

EIP をバインドするかどうかを指定します。有効な値:

• true: EIP をバインドします。

• false: EIP をバインドしません。

デフォルト値: false。

[非推奨] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

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

• PayByBandwidth: 帯域幅課金。

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

デフォルト値: PayByBandwidth。

[非推奨] 代わりに internet_charge_type と internet_max_bandwidth_out を使用してください。

EIP の最大帯域幅。単位: Mbps。

ノードプールのマネージド特徴を有効にするかどうかを指定します。有効な値:

• 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 イメージタイプ。有効な値:

• AliyunLinux: Alinux2 イメージ。

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

• AliyunLinux3: Alinux3 イメージ。

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

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

• CentOS: CentOS イメージ。

• Windows: Windows イメージ。

• WindowsCore: WindowsCore イメージ。

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

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

カスタムイメージ ID。デフォルトではシステム提供のイメージが使用されます。

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

• cloud_efficiency: Ultra ディスク。

• cloud_ssd: 標準 SSD。

• cloud_essd: ESSD。

• cloud_auto: ESSD AutoPL ディスク。

• cloud_essd_entry: ESSD Entry ディスク。

デフォルト値: cloud_efficiency。

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

有効値: [20,2048]。

ノードのシステムディスクのパフォーマンスレベル。ESSD ディスクにのみ適用されます。パフォーマンスレベルはディスクサイズに関連します。詳細については、 ESSD を参照してください。

• PL0: 比較的安定した読み取り/書き込みレイテンシを持つ中程度のピーク同時 I/O パフォーマンス。

• PL1: 比較的安定した読み取り/書き込みレイテンシを持つ中程度のピーク同時 I/O パフォーマンス。

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

• PL3: 極めて安定した読み取り/書き込みレイテンシを持つ超高ピーク同時 I/O パフォーマンス。

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

• true: 暗号化する。

• false: 暗号化しない。

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

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

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

• true: 有効にする。

• false: 無効にする。

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

ノードのシステムディスクの事前構成された読み取り/書き込み IOPS。

有効値: 0 ～ min{50,000, 1000*容量 - ベースラインパフォーマンス}。ベースラインパフォーマンス = min{1,800+50*容量, 50000}。

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

パスワードレスログイン用のキーペア名。login_password と相互排他です。

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

作成された ECS インスタンスが非ルートユーザーでログインするかどうかを指定します。

• true: 非ルートユーザー（ecs-user）としてログオンします。

• false: ルートユーザーとしてログオンします。

[非推奨] 代わりに security_hardening_os パラメーターを使用してください。

等級保護セキュリティ強化を有効にするかどうかを指定します。等級保護強化は、システムイメージが Alibaba Cloud Linux 2 または Alibaba Cloud Linux 3 に設定されている場合にのみノードで有効にできます。Alibaba Cloud は、Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3 イメージに対して等級保護 2.0 レベル III のベースラインチェック標準とスキャンプログラムを提供しています。

Alibaba Cloud OS セキュリティ強化。有効な値:

• true: Alibaba Cloud OS セキュリティ強化を有効にします。

• false: Alibaba Cloud OS セキュリティ強化を無効にします。

デフォルト値: false。

パブリック IP の課金方法。有効な値:

• PayByBandwidth: 帯域幅課金。

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

ノードの最大アウトバウンドパブリック帯域幅。単位: Mbps（メガビット/秒）。有効値: [1,100]。

Desired number of nodes in the node pool.

The total number of nodes that the node pool should maintain. We recommend configuring at least 2 nodes to ensure proper running of cluster components. You can scale in or out the node pool by adjusting the desired node count.

If no nodes need to be created, set this to 0 and manually adjust the node count later.

Multi-zone scaling group ECS instance scaling policy. Valid values:

• PRIORITY: scales based on the vSwitches (VSwitchIds.N) you defined. When ECS instances cannot be created in the zone of a higher-priority vSwitch, the next-priority vSwitch is automatically used.

• COST_OPTIMIZED: attempts to create instances from lowest to highest vCPU unit price. When multiple instance types with preemptible billing are configured, preemptible instances are created first. You can use the CompensateWithOnDemand parameter to specify whether to automatically attempt creating pay-as-you-go instances when preemptible instances cannot be created due to insufficient inventory.

  説明

  COST_OPTIMIZED takes effect only when multiple instance types or preemptible instances are configured.

• BALANCE: evenly distributes ECS instances across the multiple zones specified in the scaling group. If zones become unbalanced due to insufficient inventory, you can use the API RebalanceInstances to rebalance resources.

Default value: PRIORITY.

Scaling group mode. Valid values:

• release: standard mode. Scales by creating and releasing ECS instances based on resource usage.

• recycle: rapid mode. Scales by creating, stopping, and starting ECS instances, improving the speed of subsequent scaling (compute resources are not charged when stopped, only storage fees are charged, except for local disk instance types).

Default value: release.

Minimum number of pay-as-you-go instances required by the scaling group. Valid values: [0,1000]. When the number of pay-as-you-go instances is less than this value, pay-as-you-go instances are created first.

Percentage of pay-as-you-go instances among the excess instances after the scaling group meets the minimum pay-as-you-go instance requirement (on_demand_base_capacity). Valid values: [0,100].

Number of available instance types. The scaling group creates preemptible instances in a balanced manner among the lowest-cost instance types. Valid values: [1,10].

Whether to enable supplementing preemptible instances. When enabled, the scaling group attempts to create new instances to replace preemptible instances that are about to be reclaimed. Valid values:

• true: enable supplementing preemptible instances.

• false: disable supplementing preemptible instances.

When multi_az_policy is set to COST_OPTIMIZED, whether to allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances when preemptible instances cannot be created due to price or inventory constraints. Valid values:

• true: allow automatic creation of pay-as-you-go instances.

• false: do not allow automatic creation of pay-as-you-go instances.

Deployment set ID. You can use a deployment set to distribute ECS instances created by the node pool across different physical servers to ensure high availability and disaster recovery capabilities. When creating ECS instances in a deployment set, instances are distributed across the specified region based on the pre-configured deployment policy.

Security group ID for the node pool. Mutually exclusive with security_group_ids. We recommend using security_group_ids.

[Deprecated] Use the image_type parameter instead.

OS distribution. Valid values:

• CentOS

• AliyunLinux

• Windows

• WindowsCore

Default value: AliyunLinux.

Worker RAM role name.

• When left empty, the default Worker RAM role created by the cluster is used.

• When specified, the RAM role must be a normal service role, and its trusted service must be set to Elastic Compute Service. For more information, see Create a normal service role. When the specified RAM role is not the default Worker RAM role created by the cluster, the role name cannot start with KubernetesMasterRole- or KubernetesWorkerRole-.

ECS instance metadata access configuration.

System disk snapshot policy.

Kubelet parameter configuration.

Container runtime name. ACK supports the following three container runtimes.

• containerd: recommended, supported by all cluster versions.

• Sandboxed-Container.runv: sandboxed container with higher isolation, supported by clusters of version 1.31 or earlier.

• docker: no longer maintained, supported by clusters of version 1.22 or earlier.

Default value: containerd.

Container runtime version.

Node CPU management policy. The following two policies are supported when the cluster version is 1.12.6 or later:

• static: allows enhanced CPU affinity and exclusivity for Pods with certain resource characteristics on the node.

• none: enables the existing default CPU affinity scheme.

Default value: none.

Instance custom data. After a node joins the cluster, the specified instance custom data script is run. For more information, see User-Data scripts.

Whether scaled-out nodes are unschedulable.

• true: unschedulable.

• false: schedulable.

Whether to install CloudMonitor on ECS nodes. After installation, you can view monitoring information for created ECS instances in the CloudMonitor console. We recommend enabling this. Valid values:

• true: install CloudMonitor on ECS nodes.

• false: do not install CloudMonitor on ECS nodes.

Default value: false.

Custom node name. After setting a custom node name, the node name, ECS instance name, and ECS instance hostname are all changed accordingly.

A node name consists of three parts: prefix, node IP address, and suffix:

• Total length: 2 to 64 characters. The node name must start and end with a lowercase letter or digit.

• The prefix and suffix can contain uppercase and lowercase letters, digits, hyphens (-), and periods (.). They must start with a letter and cannot start or end with a hyphen (-) or period (.). Consecutive hyphens (-) or periods (.) are not allowed.

• The prefix is required (ECS restriction) and the suffix is optional.

• The node IP is the complete private IP address of the node.

Example: If the node IP address is 192.XX.YY.55, the prefix is aliyun.com, and the suffix is test:

• For Linux nodes, the node name, ECS instance name, and ECS instance hostname are all aliyun.com192.XX.YY.55test.

• For Windows nodes, the ECS instance hostname is 192-XX-YY-55, and the node name and ECS instance name are both aliyun.com192.XX.YY.55test.

Instance pre-custom data. Before a node joins the cluster, the specified instance pre-custom data script is run. For more information, see User-Data scripts.

Whether to enable confidential computing for the cluster.

• true: enable confidential computing.

• false: disable confidential computing.

[Deprecated]

CEN instance ID (CEN ID) bound to the enhanced edge node pool.

[Deprecated]

CCN instance ID (CCN ID) bound to the enhanced edge node pool.

[Deprecated]

Region of the CCN instance bound to the enhanced edge node pool.

[Deprecated]

Network bandwidth of the enhanced edge node pool. Unit: Mbps.

[Deprecated]

Subscription duration of the enhanced edge node pool. Unit: months.

Lingjun cluster ID to associate when creating a Lingjun node pool.

Lingjun group ID of the Lingjun cluster to associate when creating a Lingjun node pool.

Whether to enable intelligent managed mode. Valid values:

• true: enable intelligent managed mode. Can only be enabled when the cluster has intelligent managed mode enabled.

• false: disable intelligent managed mode.