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

Container Service for Kubernetes:nodepool

最終更新日:Jun 25, 2026

パラメーター

タイプ

説明

object

ノードプール。

auto_scaling

object

ノードプールのオートスケーリング設定。

enable

boolean

オートスケーリングを有効にするかどうか。

  • true:ノードプールのオートスケーリング機能を有効にします。

  • false:オートスケーリングを有効にしません。この値がfalseの場合、auto_scaling内の他の設定パラメーターは有効になりません。

デフォルト値:false

true

max_instances

integer

オートスケーリンググループ内のインスタンスの最大数。

10

min_instances

integer

オートスケーリンググループ内のインスタンスの最小数。

0

type

string

オートスケーリングのタイプ。オートスケーリングインスタンスタイプ別に分類されます。有効な値:

  • 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のピーク帯域幅。単位:Mbps。

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

テイント設定。

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:エンハンストSSD(ESSD)。

  • cloud_auto:ESSD AutoPL。

  • cloud_essd_entry:ESDDエントリー。

デフォルト値:cloud_efficiency

cloud_efficiency

system_disk_categories

array

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

  • cloud:ベーシックディスク。

  • cloud_efficiency:高効率クラウドディスク。

  • cloud_ssd:標準 SSD。

  • cloud_essd:エンハンストSSD(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容量-ベースラインパフォーマンス}。ベースラインパフォーマンス=min{1,800+50容量, 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インスタンスのマルチAZスケーリングポリシー。有効な値:

  • 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

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

10

image_type

string

オペレーティングシステムイメージタイプ。platformパラメーターとは相互排他的です。有効な値:

  • AliyunLinux:Alinux2イメージ。

  • AliyunLinux3:Alinux3イメージ。

  • AliyunLinux3Arm64:Alinux3 ARMイメージ。

  • 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を自動的に修正するかどうか。

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

count

integer

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

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

1

interconnect_mode

string

エッジノードプールのネットワークタイプ。typeedgeのノードプールにのみ有効です。有効な値:

  • basic:ベーシック。

  • private:専用。バージョン1.22 以降でサポートされています。

basic

interconnect_config

object

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

エッジノードプール設定。

cen_id

string

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

エンハンストエッジノードプールにバインドされたCloud Enterprise Network(CEN)インスタンスID。

cen-ey9k9nfhz0f*******

ccn_id

string

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

エンハンストエッジノードプールにバインドされたCloud Connect Network(CCN)インスタンスID。

ccn-qm5i0i0q9yi*******

ccn_region_id

string

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

エンハンストエッジノードプールにバインドされたCloud Connect Network(CCN)インスタンスのリージョン。

cn-shanghai

bandwidth

integer

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

エンハンストエッジノードプールのネットワーク帯域幅。単位:Mbps。

10

improved_period

string

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

エンハンストエッジノードプールの購入期間。単位:月。

1

max_nodes

integer

エッジノードプールで許可される最大ノード数。このパラメーターは0 以上である必要があります。値が0の場合、追加の制限はありません(ノードプールは、クラスターが収容できるノードの最大数によってのみ制限されます)。エッジノードプールの場合、この値は通常 0より大きくなります。ESSタイプのノードプールおよびデフォルトのエッジタイプのノードプールの場合、この値は0です。

10

node_config

object

ノード設定。

kubelet_configuration kubelet_config

Kubeletパラメーター設定。

node_components

array

ノードコンポーネントのリスト。

object

ノードコンポーネント。

name

string

ノードコンポーネント名。

kubelet

version

string

ノードコンポーネントバージョン。

1.33.3-aliyun.1

config

object

ノードコンポーネント設定。

custom_config

object

ノードコンポーネントのカスタム構成。

{"cpuManagerPolicy":"static"}

string

ノードコンポーネントのカスタム構成文字列。

cpuManagerPolicy