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

Container Service for Kubernetes:nodepool

最終更新日:Aug 21, 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_type が PrePaid にセットされている場合にのみ効果が適用されます。有効な値:

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

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

デフォルト値: true。

false

auto_renew_period

integer

ノードプールの自動更新サイクル。このパラメーターは、instance_charge_type が PrePaid にセットされている場合にのみ効果が適用され、必須です。

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 インスタンスが非ルートユーザーでログインするかどうかを指定します。

period

integer

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

デフォルト値: 1。

0

period_unit

string

ノードプール内のノードの課金期間単位。このパラメーターは、instance_charge_type が PrePaid にセットされている場合に指定する必要があります。

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

Month

platform

string

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

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

デフォルト値: AliyunLinux。

AliyunLinux

instance_patterns

array

インスタンス属性。

instance_patterns

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_id と security_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}。

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

1000

system_disk_bursting_enabled

boolean

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

  • true: 有効にします。

  • false: 無効にします。

このパラメーターは、SystemDiskCategory が cloud_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_policy が COST_OPTIMIZED に設定されている場合、価格または在庫の理由でスポットインスタンスを作成できないときに、ECS インスタンスの数量要件を満たすために従量課金インスタンスの自動作成を許可するかどうかを指定します。有効な値:

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

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

true

internet_charge_type

string

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

  • PayByBandwidth: 固定帯域幅による課金。

  • PayByTraffic: トラフィック使用量による課金。

PayByBandwidth

internet_max_bandwidth_out

integer

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

10

image_type

string

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

  • 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

ワーカー RAM ロール名。

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

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

max_parallel_repairing_nodes

string

ノードプール内に多数の異常なノードが存在する場合に並列で修復できるノードの最大数。数値(例: 5、有効な値: 1~100000)または割合(例: 10%、有効な値: 1%~100%)を指定できます。デフォルト値: 1。

5

max_unhealthy_nodes_threshold

string

自己修復のサーキットブレーカーしきい値。エラーのあるノードの数または割合がこのしきい値を超えると、自己修復はサーキットブレーカー状態に入り、新しい修復アクションの開始を停止します。数値(例: 10、有効な値: 1~100000)または割合(例: 20%、有効な値: 1%~100%)を指定できます。デフォルト値: 100%。

20%

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

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

drift_enabled

boolean

ノードローテーションを有効にするかどうかを指定します。この特徴はインテリジェントマネージドノードプールでのみサポートされており、デフォルトで有効になっています。通常のノードプールではこの特徴はサポートされていません。

count

integer

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

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

1

interconnect_mode

string

エッジノードプールのネットワークタイプ。このパラメーターは、type が edge のノードプールに対してのみ有効です。有効な値:

  • 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":"静的"}

any

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

cpuManagerPolicy

envs

array

ノードコンポーネントの環境変数。

object

name

string

環境変数の名前。

LOG_LEVEL

value

string

環境変数の値。

info