すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:nodepool

最終更新日:Jul 15, 2026

パラメーター

タイプ

説明

object

ノードプール。

auto_scaling

object

ノードプールの auto scaling 設定。

enable

boolean

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

  • true: ノードプールの auto scaling 機能を有効にします。

  • false: auto scaling を無効にします。false に設定すると、auto_scaling 内の他の設定パラメーターは効果がなくなります。

デフォルト値: false

true

max_instances

integer

auto scaling グループ内のインスタンスの最大数。

10

min_instances

integer

auto scaling グループ内のインスタンスの最小数。

0

type

string

インスタンスタイプ別に分類された auto scaling タイプ。有効な値:

  • cpu: 通常のインスタンスタイプ。

  • gpu: GPU インスタンスタイプ。

  • gpushare: GPU 共有タイプ。

  • spot: スポットインスタンスタイプ。

デフォルト値: cpu

cpu

is_bond_eip

boolean

[このフィールドは非推奨です]

EIP を関連付けるかどうかを指定します。有効な値:

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

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

デフォルト値: false

true

eip_internet_charge_type

string

[このフィールドは非推奨です]

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

  • PayByBandwidth: 固定帯域幅課金。

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

デフォルト値: PayByBandwidth。

PayByBandwidth

eip_bandwidth

integer

[このフィールドは非推奨です]

EIP のピーク帯域幅。単位: Mbit/s。

5

kubernetes_config

object

クラスター関連の構成。

cms_enabled

boolean

ECS ノードに CloudMonitor エージェントをインストールするかどうかを指定します。インストール後、CloudMonitor コンソールで作成された ECS インスタンスのモニタリング情報を確認できます。この機能を有効にすることを推奨します。有効な値:

  • true: ECS ノードに CloudMonitor エージェントをインストールします。

  • false: ECS ノードに CloudMonitor エージェントをインストールしません。

デフォルト値: false

true

cpu_policy

string

ノードの CPU 管理ポリシー。バージョン 1.12.6 以降のクラスターでは、以下の 2 つのポリシーがサポートされています。

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

  • none: 既存のデフォルト CPU アフィニティスキームを有効にします。

デフォルト値: none

none

labels

array

ノードラベル。Kubernetes クラスターのノードにラベルを追加します。

tag

ノードラベル。

runtime

string

コンテナランタイム。有効な値:

  • containerd: 推奨。すべてのクラスターバージョンをサポートします。

  • Sandboxed-Container.runv: より高い隔離を提供するサンドボックスコンテナ。バージョン 1.24 以前のクラスターをサポートします。

  • docker: バージョン 1.22 以前のクラスターをサポートします。

デフォルト値: containerd

containerd

runtime_version

string

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

1.6.20

taints

array

Taint 構成。

taint

Taint 構成。

user_data

string

ノードのカスタムデータ。

MXM=

node_name_mode

string

ノード名は、プレフィックス + ノード IP + サフィックスの 3 つの部分で構成されます。

  • プレフィックスとサフィックスはどちらも、「.」で区切られた 1 つ以上の部分で構成できます。各部分には小文字、数字、ハイフン (-) を含めることができます。ノード名は小文字または数字で始まり、小文字または数字で終わる必要があります。

  • ノード IP は、ノードの完全な非公開 IP アドレスです。

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

customized,aliyun,ip,com

nodepool_info

object

ノードプールの構成。

name

string

ノードプール名。

np-test

resource_group_id

string

ノードプールのリソースグループ ID。

rg-acfmyvw3wjm****

type

string

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

  • ess: ノードプール。

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

ess

scaling_group

object

ノードプールのスケーリンググループ構成。

auto_renew

boolean

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

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

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

デフォルト値: true

false

auto_renew_period

integer

ノードプールの自動更新期間。このパラメーターは、instance_charge_typePrePaid に設定されている場合にのみ効果があり、必須です。

PeriodUnit=Month の場合、有効な値: {1, 2, 3, 6, 12}。

デフォルト値: 1。

0

data_disks

array

ノードプール内のノードのデータクラウドディスク構成。

data_disk

ノードプール内のノードのデータクラウドディスク構成。

disk_init

array

ブロックデバイスの初期化構成。

DiskInit

DiskInit 構成。

image_id

string

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

aliyun_2_1903_x64_20G_alibase_20200904.vhd

instance_charge_type

string

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

  • PrePaid: サブスクリプション。

  • PostPaid: 従量課金。

デフォルト値: PostPaid

PostPaid

instance_types

array

インスタンスタイプ。

string

インスタンスタイプ。

ecs.n1.medium

key_pair

string

キーペア名。このパラメーターまたは login_password のいずれかを指定します。

説明

マネージドノードプールを作成する場合、key_pair のみがサポートされます。

np-key

login_password

string

SSH ログインパスワード。このパラメーターまたは key_pair のいずれかを指定します。パスワードの長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

Hello1234

login_as_non_root

boolean

スケールアウトされた ECS インスタンスに非 root ユーザーでログインするかどうかを指定します。

period

integer

ノードプール内のノードのサブスクリプション期間。このパラメーターは、instance_charge_typePrePaid に設定されている場合にのみ効果があり、必須です。period_unit が Month に設定されている場合、period の有効な値は {1, 2, 3, 6, 12} です。

デフォルト値: 1。

0

period_unit

string

ノードプール内のノードのサブスクリプション期間単位。このパラメーターは、instance_charge_typePrePaid に設定されている場合に指定する必要があります。

Month: 現在、単位としてサポートされているのは月のみです。

Month

platform

string

オペレーティングシステムのディストリビューション。有効な値:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

デフォルト値: AliyunLinux

AliyunLinux

rds_instances

array

RDS インスタンスのリスト。

string

RDS インスタンス ID。

rm-2zey3t89t6280****

spot_strategy

string

スポットインスタンスのタイプ。有効な値:

  • NoSpot: 非スポットインスタンス。

  • SpotWithPriceLimit: 値幅制限付きスポットインスタンス。

  • SpotAsPriceGo: システムが現在の市場価格で自動的に入札します。

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

NoSpot

spot_price_limit

array

単一のスポットインスタンスタイプの市場価格範囲構成。

object

instance_type

string

スポットインスタンスタイプ。

ecs.c6.large

price_limit

string

単一インスタンスの最大価格。

0.39

scaling_policy

string

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

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

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

デフォルト値: release

release

security_group_id

string

ノードプールのセキュリティグループ ID。このパラメーターまたは security_group_ids のいずれかを指定します。security_group_ids を使用することを推奨します。

sg-2zeihch86ooz9io4****

security_group_ids

array

セキュリティグループ ID のリスト。このパラメーターまたは security_group_id のいずれかを指定します。security_group_ids を使用することを推奨します。security_group_idsecurity_group_ids の両方が指定されている場合、security_group_ids が優先されます。

string

セキュリティグループ ID。

sg-2zeihch86ooz9io4****

system_disk_category

string

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

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

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

  • cloud_essd_entry: ESSD Entry ディスク。

デフォルト値: cloud_efficiency

cloud_efficiency

system_disk_categories

array

システムクラウドディスクの複数のクラウドディスクタイプ。優先度の高いクラウドディスクタイプが利用できない場合、システムは自動的に次の優先度のクラウドディスクタイプを使用してシステムクラウドディスクを作成しようとします。有効な値:

  • cloud: 基本クラウドディスク。

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

string

ノードのシステムクラウドディスクタイプ。

cloud_essd

system_disk_size

integer

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

有効な値: [40,500]。

120

system_disk_performance_level

string

ノードシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ効果があります。

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

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

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

  • PL3: 超高い最大同時 I/O パフォーマンスと、極めて安定した読み取り/書き込みレイテンシ。

PL1

system_disk_encrypted

boolean

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

system_disk_kms_key_id

string

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

0e478b7a-4262-4802-b8cb-00d3fb40****

system_disk_encrypt_algorithm

string

ノードシステムクラウドディスクの暗号化アルゴリズム。有効な値: aes-256。

aes-256

system_disk_provisioned_iops

integer

ノードシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。有効な値: 0~min{50,000, 1000*capacity-baseline performance}。ベースラインパフォーマンス=min{1,800+50*capacity, 50000}。

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

1000

system_disk_bursting_enabled

boolean

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

  • true: 有効。

  • false: 無効。

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

true

tags

array

ECS インスタンスにのみタグを追加します。

タグキーは重複できず、最大 128 文字です。タグキーとタグ値は "aliyun" または "acs:" で始まることや、"https://" または "http://" を含むことはできません。

object

key

string

タグキー。

key

value

string

タグ値。

value

vswitch_ids

array

vSwitch ID。

string

vSwitch ID。

vsw-2ze0fmpbwo140ahni****

multi_az_policy

string

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

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

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

    説明

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

  • BALANCE: スケーリンググループで指定された複数のゾーン全体に ECS インスタンスを均等に割り当てます。在庫不足などの理由でゾーンのバランスが崩れた場合、RebalanceInstances API を使用してリソースの再バランスを行うことができます。詳細については、「 RebalanceInstances 」を参照してください。

デフォルト値: PRIORITY

COST_OPTIMIZED

on_demand_base_capacity

integer

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

0

on_demand_percentage_above_base_capacity

integer

従量課金インスタンスの最小数 (on_demand_base_capacity) を超えるインスタンスのうち、従量課金インスタンスの割合。有効な値: [0,100]。

20

spot_instance_pools

integer

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

5

spot_instance_remedy

boolean

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

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

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

false

compensate_with_on_demand

boolean

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

  • true: ECS インスタンス数の要件を満たすために、従量課金インスタンスの自動作成を許可します。

  • false: ECS インスタンス数の要件を満たすために、従量課金インスタンスの自動作成を許可しません。

true

internet_charge_type

string

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

  • PayByBandwidth: 固定帯域幅課金。

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

PayByBandwidth

internet_max_bandwidth_out

integer

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

10

image_type

string

オペレーティングシステムのイメージタイプ。このパラメーターまたは platform パラメーターのいずれかを指定します。有効な値:

  • AliyunLinux: Alinux2 イメージ。

  • AliyunLinux3: Alinux3 イメージ。

  • AliyunLinux3Arm64: ARM 用 Alinux3 イメージ。

  • AliyunLinuxUEFI: Alinux2 UEFI イメージ。

  • CentOS: CentOS イメージ。

  • Windows: Windows イメージ。

  • WindowsCore: WindowsCore イメージ。

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

AliyunLinux

deploymentset_id

string

デプロイメントセット ID。

ds-bp1d19mmbsv3jf6xxxxx

desired_size

integer

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

2

private_pool_options

object

非公開プール構成。

id

string

非公開プール ID。

eap-bp67acfmxazb4****

match_criteria

string

非公開プールタイプ。インスタンス起動時の非公開プール容量オプションです。エラスティシティ保証または容量予約が有効になると、インスタンス起動用の非公開プールが生成されます。有効な値:

  • Open: オープンモード。オープンタイプの非公開プール容量を自動的にマッチングします。一致する非公開プール容量がない場合、パブリックプールリソースが起動に使用されます。

  • Target: ターゲットモード。指定された非公開プール容量を使用してインスタンスを起動します。指定された非公開プール容量が利用できない場合、インスタンスの起動は失敗します。

  • None: なしモード。インスタンス起動時に非公開プール容量を使用しません。

Open

ram_role_name

string

Worker RAM ロール名。

重要 バージョン 1.22 以降の ACK マネージドクラスターのみが、ノードプール作成時にこのパラメーターの設定をサポートしています。

example-role

instance_metadata_options InstanceMetadataOptions

ECS インスタンスメタデータのアクセス構成。 このパラメーターは現在、ホワイトリストに登録されたアカウントでのみ利用可能です。申請するにはチケットを提出してください。

resource_pool_options

object

インスタンス作成時に使用されるリソースプールおよびリソースプールポリシー。このパラメーターを設定する際は、以下の点にご注意ください: このパラメーターは従量課金インスタンスの作成時にのみ効果があります。 このパラメーターは private_pool_options.match_criteria または private_pool_options.id と同時に設定することはできません。

strategy

string

インスタンス作成時に使用されるリソースプールポリシー。リソースプールには、エラスティシティ保証または容量予約が有効になった後に生成される非公開プールと、インスタンス起動用のパブリックプールが含まれます。有効な値: PrivatePoolFirst: 非公開プール優先。このオプションが選択され、resource_pool_options.private_pool_ids が指定されている場合、指定された非公開プールが最初に使用されます。非公開プールが指定されていないか、指定された非公開プールの容量が不足している場合、オープンタイプの非公開プールが自動的にマッチングされます。一致する非公開プールがない場合、パブリックプールがインスタンス作成に使用されます。 PrivatePoolOnly: 非公開プールのみ。このオプションが選択された場合、resource_pool_options.private_pool_ids を指定する必要があります。指定された非公開プールの容量が不足している場合、インスタンスの起動は失敗します。 None: リソースプールポリシーなし。 デフォルト値: None。

PrivatePoolFirst

private_pool_ids

array

非公開プール ID のリスト。エラスティシティ保証 ID または容量予約 ID です。ターゲットモードの非公開プール ID のみを渡すことができます。N の有効な値: 1~20。

string

非公開プール ID。エラスティシティ保証 ID または容量予約 ID です。ターゲットモードの非公開プール ID のみを渡すことができます。

eap-bp67acfmxazb4****

tee_config

object

機密コンピューティングノードプールの構成。

tee_enable

boolean

これが機密コンピューティングノードプールであるかどうかを指定します。

false

management

object

マネージドノードプールの構成。

enable

boolean

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

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

  • false: マネージドノードプールを無効にします。その他の関連構成は、enable=true の場合にのみ効果があります。

false

auto_repair

boolean

自動修復を有効にするかどうかを指定します。このパラメーターは、enable=true の場合にのみ効果があります。

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

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

false

upgrade_config

object

自動スペックアップ構成。このパラメーターは、enable=true の場合にのみ有効です。

auto_upgrade

boolean

自動スペックアップを有効にするかどうかを指定します。有効な値:

  • true: 自動スペックアップを有効にします。

  • false: 自動スペックアップを無効にします。

false

surge

integer

追加ノードの数。

0

surge_percentage

integer

追加ノードの割合。これか surge のいずれかを選択します。

0

max_unavailable

integer

使用不可ノードの最大数。有効な値: [1,1000]。

デフォルト値: 1。

0

auto_repair_policy

object

自動修復ノードポリシー。

restart_node

boolean

ノードの再起動を許可するかどうかを指定します。

true

auto_vul_fix

boolean

CVE を自動的に修正するかどうかを指定します。 [properties.management.properties.auto_v

true

auto_vul_fix_policy

object

自動 CVE 修正ポリシー。

restart_node

boolean

ノードの再起動を許可するかどうかを指定します。

true

vul_level

string

自動修正が許可される脆弱性レベル (カンマ区切り)。

asap,nntf

auto_upgrade

boolean

自動スペックアップが有効かどうかを指定します。

true

auto_upgrade_policy

object

自動スペックアップポリシー。

auto_upgrade_kubelet

boolean

kubelet の自動スペックアップを許可するかどうかを指定します。

true

auto_fault_diagnosis

boolean

drift_enabled

boolean

count

integer

[このフィールドは非推奨です。代わりに desired_size を使用してください。]

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

1

interconnect_mode

string

The network type of the edge node pool. This value is valid only for node pools whose type is edge. Valid values:

  • basic: basic.

  • private: dedicated. Supported in version 1.22 and later.

basic

interconnect_config

object

[This field is deprecated.]

The edge node pool configuration.

cen_id

string

[This field is deprecated]

The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool.

cen-ey9k9nfhz0f*******

ccn_id

string

[This field is deprecated]

The Cloud Connect Network (CCN) instance ID bound to the enhanced edge node pool.

ccn-qm5i0i0q9yi*******

ccn_region_id

string

[This field is deprecated]

The region of the Cloud Connect Network (CCN) instance bound to the enhanced edge node pool.

cn-shanghai

bandwidth

integer

[This field is deprecated]

The network bandwidth of the enhanced edge node pool. Unit: Mbit/s.

10

improved_period

string

[This field is deprecated]

The purchase duration of the enhanced edge node pool. Unit: months.

1

max_nodes

integer

The maximum number of nodes allowed in the edge node pool. This parameter must be greater than or equal to 0. A value of 0 indicates no additional limit (the node pool is limited only by the maximum number of nodes that the cluster can accommodate). For edge node pools, this value is typically greater than 0. For ESS-type node pools and default edge-type node pools, this value is 0.

10

node_config

object

The node configuration.

kubelet_configuration kubelet_config

The Kubelet parameter settings.

node_components

array

The list of node components.

object

The node component.

name

string

The node component name.

kubelet

version

string

The node component version.

1.33.3-aliyun.1

config

object

The node component configuration.

custom_config

object

The node component custom configuration.

{"cpuManagerPolicy":"static"}

any

The node component custom configuration string.

cpuManagerPolicy