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

Container Service for Kubernetes:nodepool

最終更新日:Jul 17, 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: 高速モード。ECS インスタンスの作成、停止、または開始によってスケールインまたはスケールアウトし、後続のスケーリング操作の速度を向上させます。(停止中のインスタンスにはコンピューティングリソースの料金はかかりませんが、ローカルディスクを持つインスタンスを除き、ストレージ料金は引き続き発生します。)

デフォルト値: 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 操作を呼び出してリソースのバランスを再調整できます。詳細については、「 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 です。

eap-bp67acfmxazb4****

cpu_options

object

CPU 設定オプション。

nested_virtualization

string

入れ子になった仮想化を有効にするかどうかを指定します。有効な値: disabled: 入れ子になった仮想化は無効です。 enabled: 入れ子になった仮想化は有効です。

enabled

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

Specifies whether to enable auto upgrade.

true

auto_upgrade_policy

object

The auto upgrade policy.

auto_upgrade_kubelet

boolean

kubelet の自動アップグレードを許可するかどうかを指定します。 [properties.management.properties.auto_fault_diagnosis

true

auto_fault_diagnosis

boolean

Specifies whether to enable node self-healing ECS fault detection.

drift_enabled

boolean

Specifies whether to enable node rotation. Only intelligent managed node pools support this feature, and it is enabled by default. Common node pools do not support this feature.

count

integer

This field is deprecated. Use desired_size instead.

The number of nodes in the node pool.

1

interconnect_mode

string

The network type of the edge node pool. This parameter 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 instance ID of the Cloud Enterprise Network (CEN) attached to the enhanced edge node pool.

cen-ey9k9nfhz0f*******

ccn_id

string

This field is deprecated.

The instance ID of the Cloud Connect Network (CCN) attached 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: Mbps.

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 (limited only by the maximum number of nodes the cluster can accommodate, with no additional limit on the node pool itself). This value is typically greater than 0 for edge node pools. 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 node component list.

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 custom configuration of the node component.

{"cpuManagerPolicy":"static"}

any

The custom configuration string of the node component.

cpuManagerPolicy