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

Container Service for Kubernetes:CreateClusterNodePool

最終更新日:Apr 04, 2026

ノードプールは、同じプロパティを共有するノードの論理的なコレクションであり、ノードのアップグレードや Auto Scaling などの統一された管理および運用保守 (O&M) 操作を可能にします。さらに、ノードプールの自動 O&M 機能を活用して、OS の CVE 脆弱性の自動パッチ適用、障害ノードの自動回復、kubelet および containerd バージョンの自動アップグレードなどにより、運用コストを削減できます。CreateClusterNodePool を呼び出すことで、クラスターのノードプールを作成できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cs:CreateClusterNodePool

create

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

なし なし

リクエスト構文

POST /clusters/{ClusterId}/nodepools HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

ClusterId

string

必須

クラスターの ID です。

c61da77e8bfbc4c4c999af2b51b65****

リクエストパラメーター

パラメーター

必須 / 任意

説明

body

object

任意

リクエストボディです。

nodepool_info

object

任意

ノードプールの設定です。

name

string

必須

ノードプールの名前です。

nodepool-test

type

string

任意

ノードプールのタイプです。有効値:

  • ess:通常ノードプール。マネージドノードプール機能と Auto Scaling 機能をサポートします。

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

  • lingjun:Lingjun ノードプール。

列挙値:

  • lingjun :
  • edge :
  • ess :

ess

resource_group_id

string

任意

ノードプールが属するリソースグループの ID です。ノードプールに追加されたインスタンスは、このリソースグループに属します。

rg-acfmyvw3wjmb****

auto_scaling

object

任意

Auto Scaling の設定です。

enable

boolean

任意

ノードプールの Auto Scaling を有効にするかどうかを指定します。有効値:

  • true:Auto Scaling を有効にします。

  • false:Auto Scaling を無効にします。このパラメーターを false に設定した場合、auto_scaling セクションの他のパラメーターは有効になりません。

デフォルト値:false

false

type

string

任意

Auto Scaling に使用されるインスタンスタイプです。このパラメーターは、enable が true に設定されている場合にのみ有効になります。有効値:

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

  • gpu:GPU インスタンス。

  • gpushare:共有 GPU インスタンス。

  • spot:プリエンプティブルインスタンス。

デフォルト値:cpu

説明

ノードプール作成後にこのパラメーターを変更することはできません。

列挙値:

  • spot :
  • cpu :
  • gpushare :
  • gpu :

cpu

max_instances

integer

任意

ノードプール内の Elastic Compute Service (ECS) インスタンスをスケールできる最大数です。ノードプール内のノード数はこの値を超えることはできません。このパラメーターは、enable が true に設定されている場合にのみ有効になります。有効値:[min_instances, 2000]。デフォルト値:0。

10

min_instances

integer

任意

ノードプール内の ECS インスタンスをスケールできる最小数です。ノードプール内のノード数はこの値を下回ることはできません。このパラメーターは、enable が true に設定されている場合にのみ有効になります。有効値:[0, max_instances]。デフォルト値:0。

1

is_bond_eip deprecated

boolean

任意

このパラメーターは非推奨です。

Elastic IP アドレス (EIP) をノードプールに関連付けるかどうかを指定します。有効値:

  • true:EIP をノードプールに関連付けます。

  • false:EIP をノードプールに関連付けません。

デフォルト値:false

**

重要:このパラメーターは非推奨です。代わりに internet_charge_type および internet_max_bandwidth_out パラメーターを使用してください。

null

eip_internet_charge_type deprecated

string

任意

このパラメーターは非推奨です。

EIP の課金方法です。有効値:

  • PayByBandwidth:帯域幅課金。

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

デフォルト値:PayByBandwidth

**

重要:このパラメーターは非推奨です。代わりに internet_charge_type および internet_max_bandwidth_out パラメーターを使用してください。

null

eip_bandwidth deprecated

integer

任意

このパラメーターは非推奨です。

EIP の最大帯域幅です。単位:Mbit/s。

**

重要:このパラメーターは非推奨です。代わりに internet_charge_type および internet_max_bandwidth_out パラメーターを使用してください。

null

management

object

任意

マネージドノードプール機能の設定です。

enable

boolean

任意

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

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

  • false:マネージドノードプール機能を無効にします。このセクションの他のパラメーターは、enable が true に設定されている場合にのみ有効になります。

デフォルト値:false。

false

auto_repair

boolean

任意

自動ノード修復を有効にするかどうかを指定します。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

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

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

enable が true に設定されている場合、このパラメーターのデフォルト値は true です。enable が false に設定されている場合、このパラメーターのデフォルト値は false です。

true

auto_repair_policy

object

任意

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

restart_node

boolean

任意

ノードの再起動を許可するかどうかを指定します。このパラメーターは、auto_repair が true に設定されている場合にのみ有効になります。有効値:

  • true:ノードの再起動を許可します。

  • false:ノードの再起動を許可しません。

auto_repair が true に設定されている場合、このパラメーターのデフォルト値は true です。auto_repair が false に設定されている場合、このパラメーターのデフォルト値は false です。

true

approval_required

boolean

任意

エッジゾーンの修復に手動承認が必要かどうか。

auto_vul_fix

boolean

任意

共通脆弱性識別子 (CVE) の自動パッチ適用を有効にするかどうかを指定します。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

  • true:自動 CVE パッチ適用を有効にします。

  • false:自動 CVE パッチ適用を無効にします。

enable が true に設定されている場合、このパラメーターのデフォルト値は true です。enable が false に設定されている場合、このパラメーターのデフォルト値は false です。

true

auto_vul_fix_policy

object

任意

自動 CVE パッチ適用ポリシーです。

restart_node

boolean

任意

ノードの再起動を許可するかどうかを指定します。このパラメーターは、auto_vul_fix が true に設定されている場合にのみ有効になります。有効値:

  • true:ノードの再起動を許可します。

  • false:ノードの再起動を許可しません。auto_vul_fix が true に設定されている場合、このパラメーターのデフォルト値は false です。auto_vul_fix が false に設定されている場合、このパラメーターのデフォルト値は false です。

false

vul_level

string

任意

自動的にパッチを適用できる CVE の深刻度レベルです。複数のレベルをコンマ (,) で区切ります。例:asap,later。有効値:

  • asap:高。

  • later:中。

  • nntf:低。

auto_vul_fix が true に設定されている場合、このパラメーターのデフォルト値は asap です。

asap,nntf

exclude_packages

string

任意

脆弱性修正中に除外するパッケージです。

デフォルト値:kernel

kernel

auto_upgrade

boolean

任意

自動ノードアップグレードを有効にするかどうかを指定します。このパラメーターは、enable が true に設定されている場合にのみ有効になります。

  • true:自動ノードアップグレードを有効にします。

  • false:自動ノードアップグレードを無効にします。

enable が true に設定されている場合、このパラメーターのデフォルト値は true です。enable が false に設定されている場合、このパラメーターのデフォルト値は false です。

true

auto_upgrade_policy

object

任意

自動ノードアップグレードポリシーです。

auto_upgrade_kubelet

boolean

任意

kubelet の自動アップグレードを許可するかどうかを指定します。このパラメーターは、auto_upgrade が true に設定されている場合にのみ有効になります。有効値:

  • true:kubelet の自動アップグレードを許可します。

  • false:kubelet の自動アップグレードを許可しません。

auto_upgrade が true に設定されている場合、このパラメーターのデフォルト値は true です。auto_upgrade が false に設定されている場合、このパラメーターのデフォルト値は false です。

true

auto_upgrade_runtime

boolean

任意

ランタイムの自動アップグレードを許可するかどうかを指定します。このパラメーターは、auto_upgrade が true に設定されている場合にのみ有効になります。有効値:

  • true:ランタイムの自動アップグレードを許可します。

  • false:ランタイムの自動アップグレードを許可しません。

デフォルト値:false

false

auto_upgrade_os

boolean

任意

OS の自動アップグレードを許可するかどうかを指定します。このパラメーターは、auto_upgrade が true に設定されている場合にのみ有効になります。有効値:

  • true:OS の自動アップグレードを許可します。

  • false:OS の自動アップグレードを許可しません。

デフォルト値:false

false

upgrade_config deprecated

object

任意

自動アップグレードの設定です。この設定は、enable が true に設定されている場合にのみ有効になります。

auto_upgrade deprecated

boolean

任意

自動アップグレードを有効にするかどうかを指定します。有効値:

  • true:自動 OS アップグレードを有効にします。

  • false:自動 OS アップグレードを無効にします。

**

注意:このパラメーターは非推奨です。代わりに前述の auto_upgrade パラメーターを使用してください。

null

surge

integer

任意

自動アップグレード中にノードプールに一時的に追加されるノードの数です。

0

surge_percentage

integer

任意

自動アップグレード中にノードプールに一時的に追加される追加ノードの割合です。このパラメーターまたは surge を設定する必要があります。

0

max_unavailable

integer

任意

利用不可状態にできるノードの最大数です。有効値:1~1000。

デフォルト値:1。

1

scaling_group

object

任意

ノードプールで使用されるスケーリンググループの設定です。

vswitch_ids

array

必須

vSwitch の ID です。1 つから 8 つの vSwitch ID を指定できます。

説明

高可用性を確保するため、異なるゾーンにある vSwitch を選択することを推奨します。

string

任意

vSwitch の ID です。

vsw-wz9mfnhmssud6eicu****

instance_types

array

必須

ノードプール内のノードのインスタンスタイプです。システムがノードプールにノードを追加する際、指定されたインスタンスタイプの中からノードに最も適したものを選択します。1 つから 10 個のインスタンスタイプを指定できます。

説明

高可用性を確保するため、複数のインスタンスタイプを指定することを推奨します。

string

任意

インスタンスタイプです。

ecs.d1ne.2xlarge

instance_charge_type

string

必須

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

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

  • PostPaid:従量課金。

デフォルト値:PostPaid

列挙値:

  • PostPaid :
  • PrePaid :

PostPaid

period

integer

任意

ノードプール内のノードのサブスクリプション期間です。このパラメーターは、instance_charge_typePrePaid に設定した場合に有効かつ必須です。

  • 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 です。

1

period_unit

string

任意

ノードプール内のノードの課金サイクルです。このパラメーターは、instance_charge_typePrePaid に設定した場合にのみ有効かつ必須です。有効値:

  • Month:サブスクリプション期間は月単位で測定されます。

  • Week:サブスクリプション期間は週単位で測定されます。

デフォルト値:Month

Month

auto_renew

boolean

任意

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

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

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

デフォルト値:false

true

auto_renew_period

integer

任意

自動更新期間です。有効値:

  • PeriodUnit が Week に設定されている場合の有効値:1、2、3。

  • PeriodUnit が Month に設定されている場合の有効値:1、2、3、6、12、24、36、48、60。

デフォルト値:1。

1

spot_strategy

string

任意

プリエンプティブルインスタンスの入札ポリシーです。有効値:

  • NoSpot:非プリエンプティブル。

  • SpotWithPriceLimit:プリエンプティブルインスタンスの最高入札価格を指定します。

  • SpotAsPriceGo:最新の市場価格に基づいて自動的に入札を送信します。

詳細については、「プリエンプティブルインスタンスの使用」をご参照ください。

NoSpot

spot_price_limit

array<object>

任意

プリエンプティブルインスタンスのインスタンスタイプと、そのインスタンスタイプの価格上限です。

object

任意

プリエンプティブルインスタンスの価格上限です。インスタンスタイプごとに異なる価格上限を指定できます。

instance_type

string

任意

プリエンプティブルインスタンスのインスタンスタイプです。

ecs.c6.large

price_limit

string

任意

そのタイプのプリエンプティブルインスタンスの価格上限です。

0.39

image_type

string

任意

OS イメージのタイプです。このパラメーターまたは platform を指定する必要があります。有効値:

  • AliyunLinux:Alibaba Cloud Linux 2。

  • AliyunLinuxSecurity:Alibaba Cloud Linux 2 (UEFI)。

  • AliyunLinux3:Alibaba Cloud Linux 3

  • AliyunLinux3Arm64:Alibaba Cloud Linux 3 for ARM。

  • AliyunLinux3Security:Alibaba Cloud Linux 3 for ARM。

  • CentOS:CentOS。

  • Windows:Windows。

  • WindowsCore:Windows Core。

  • ContainerOS:ContainerOS。

  • AliyunLinux3ContainerOptimized:Alibaba Cloud Linux 3 Container-optimized。

AliyunLinux3

image_id

string

任意

カスタムイメージ ID です。デフォルトでは、Container Service for Kubernetes (ACK) が提供するイメージが使用されます。

aliyun_2_1903_x64_20G_alibase_20200529.vhd

system_disk_category

string

任意

システムディスクのカテゴリです。有効値:

  • cloud:基本ディスク。

  • cloud_efficiency:Ultra ディスク。

  • cloud_ssd:標準 SSD。

  • cloud_essd:ESSD。

  • cloud_auto:ESSD AutoPL ディスク。

  • cloud_essd_entry:ESSD エントリーディスク。

デフォルト値:cloud_efficiency

cloud_efficiency

system_disk_categories

array

任意

ノードのシステムディスクのカテゴリです。優先度の高いディスクカテゴリが利用できない場合、システムは優先度の低いディスクカテゴリのシステムディスクを作成しようとします。有効値:

  • cloud:基本ディスク。

  • cloud_efficiency:Ultra ディスク。

  • cloud_ssd:標準 SSD。

  • cloud_essd:ESSD。

  • cloud_auto:ESSD AutoPL ディスク。

  • cloud_essd_entry:ESSD エントリーディスク。

string

任意

ノードのシステムディスクのカテゴリです。

cloud_essd

system_disk_size

integer

任意

システムディスクのサイズです。単位:GiB。

有効値:20~20248。

120

system_disk_performance_level

string

任意

システムディスクの PL です。このパラメーターは ESSD にのみ有効です。

  • PL0:中程度の最大同時 I/O パフォーマンスと低い I/O レイテンシ。

  • PL1:中程度の最大同時 I/O パフォーマンスと低い I/O レイテンシ。

  • PL2:高い最大同時 I/O パフォーマンスと低い I/O レイテンシ。

  • PL3:超高最大同時 I/O パフォーマンスと超低 I/O レイテンシ。

説明

Alibaba Cloud ディスクは上記の PL をサポートしていますが、ディスクを作成する際に利用可能な PL は選択した ECS インスタンスタイプによって異なります。詳細については、「ECS インスタンスファミリーの概要」をご参照ください。

PL1

system_disk_encrypted

boolean

任意

システムディスクを暗号化するかどうかを指定します。true:システムディスクを暗号化します。false:システムディスクを暗号化しません。

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_bursting_enabled

boolean

任意

システムディスクのバースト機能を有効にするかどうかを指定します。有効値:

  • true:バースト機能を有効にします。

  • false:バースト機能を無効にします。

このパラメーターは、SystemDiskCategorycloud_auto に設定されている場合にのみ利用可能です。詳細については、「ESSD AutoPL ディスク」をご参照ください。

true

system_disk_provisioned_iops

integer

任意

システムディスクの事前設定 IOPS です。有効値:0~min{50,000, 1,000 × 容量 - ベースライン IOPS}。ベースライン IOPS = min{1,800 + 50 × 容量, 50,000}。

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

1000

data_disks

array

任意

ノードプール内のノードにアタッチされるデータディスクの設定です。

data_disk

任意

データディスクの設定です。

disk_init

array

任意

ブロックデバイスの初期化設定です。

DiskInit

任意

DiskInit の設定です。

security_group_ids

array

任意

セキュリティグループの ID です。このパラメーターまたは security_group_id を指定する必要があります。security_group_ids を指定することを推奨します。security_group_idsecurity_group_ids の両方を指定した場合、security_group_ids が使用されます。

string

任意

セキュリティグループ ID です。このパラメーターまたは security_group_id を指定する必要があります。security_group_ids を指定することを推奨します。security_group_idsecurity_group_ids の両方を指定した場合、security_group_ids が使用されます。

sg-wz9a8g2mt6x5ll******

key_pair

string

任意

ノードプール内のノードにログインするために使用するキーペアの名前です。このパラメーターまたは login_password を設定する必要があります。

説明

ノードプールのノードの OS として ContainerOS を選択した場合、key_pair を指定する必要があります。

np-key-name

login_password

string

任意

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

****

login_as_non_root

boolean

任意

ノードプールに追加された ECS インスタンスに非 root ユーザーがログインすることを許可するかどうかを指定します。

true

cis_enabled deprecated

boolean

任意

このパラメーターは非推奨です。代わりに security_hardening_os を使用してください。

null

soc_enabled

boolean

任意

MLPS セキュリティ強化を有効にするかどうかを指定します。多層防御体系 (MLPS) に基づくセキュリティ強化は、ノードに Alibaba Cloud Linux 2 または Alibaba Cloud Linux 3 がインストールされている場合にのみ有効にできます。Alibaba Cloud は、Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3 イメージが MLPS 2.0 のレベル 3 基準に準拠していることを保証するためのベースラインチェックとスキャナーを提供します。

false

security_hardening_os

boolean

任意

Alibaba Cloud Linux セキュリティ強化が有効になっているかどうかを示します。有効値:

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

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

デフォルト値:false

false

internet_charge_type

string

任意

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

  • PayByBandwidth:帯域幅課金。

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

PayByTraffic

internet_max_bandwidth_out

integer

任意

パブリック IP アドレスの最大アウトバウンド帯域幅です。単位:Mbit/s。有効値:1~100。

5

tags

array<object>

任意

ECS インスタンスにのみ追加したいタグです。

タグキーは一意である必要があり、長さは 128 文字を超えることはできません。タグキーと値は aliyun または acs: で始めることはできず、https:// または http:// を含むことはできません。

object

任意

タグです。

key

string

任意

タグキーです。

node-k-1

value

string

任意

タグ値です。

node-v-1

desired_size

integer

任意

ノードプール内の期待されるノード数です。

0

multi_az_policy

string

任意

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

  • PRIORITY:ECS インスタンスは VSwitchIds.N の値に基づいてスケーリングされます。最も優先度の高い vSwitch が存在するゾーンで ECS インスタンスを作成できない場合、システムは次に優先度の高い vSwitch が存在するゾーンで ECS インスタンスを作成します。

  • COST_OPTIMIZED:ECS インスタンスは vCPU 単価の昇順で作成されます。スケーリング設定でプリエンプティブルインスタンスタイプが指定されている場合、プリエンプティブルインスタンスが優先的に作成されます。CompensateWithOnDemand パラメーターを設定して、在庫不足によりプリエンプティブルインスタンスを作成できない場合に、従量課金インスタンスを自動的に作成するかどうかを指定できます。

    **

    COST_OPTIMIZED は、複数のインスタンスタイプが指定されているか、少なくとも 1 つのプリエンプティブルインスタンスタイプが指定されている場合にのみ有効です。

  • BALANCE:ECS インスタンスはスケーリンググループの複数のゾーンに均等に分散されます。在庫不足により複数のゾーン間で ECS インスタンスが不均衡になった場合、Auto Scaling の RebalanceInstances 操作を呼び出して、ゾーン間で ECS インスタンスを均等に分散できます。

デフォルト値:PRIORITY

COST_OPTIMIZED

scaling_policy

string

任意

スケーリンググループのスケーリングモードです。有効値:

  • release:標準モード。ECS インスタンスはリソース使用量に基づいて作成およびリリースされます。

  • recycle:高速モード。ECS インスタンスはスケーリングイベント中に作成、停止、または開始されます。これにより、次のスケールアウトイベントに必要な時間が短縮されます。インスタンスが停止している間は、ストレージサービスに対してのみ課金されます。これは、ローカルディスクがアタッチされた ECS インスタンスには適用されません。

デフォルト値:release

release

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

任意

プリエンプティブルインスタンスを作成するために利用可能なインスタンスタイプの数です。Auto Scaling は、最も低コストで利用可能な複数のインスタンスタイプのプリエンプティブルインスタンスを作成します。有効値:1~10。

5

spot_instance_remedy

boolean

任意

プリエンプティブルインスタンスを補充できるかどうかを示します。このパラメーターを true に設定すると、スケーリンググループがプリエンプティブルインスタンスが回収されることを示すシステムメッセージを受信したときに、スケーリンググループはこのインスタンスを置き換えるために新しいインスタンスを作成しようとします。有効値:

  • true:プリエンプティブルインスタンスの補充を有効にします。

  • false:プリエンプティブルインスタンスの補充を無効にします。

false

compensate_with_on_demand

boolean

任意

価格や在庫不足などの理由でプリエンプティブルインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成するかどうかを指定します。このパラメーターは、multi_az_policyCOST_OPTIMIZED に設定した場合に有効になります。有効値:

  • true:プリエンプティブルインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスを自動的に作成します。

  • false:プリエンプティブルインスタンスを作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスを作成しません。

true

deploymentset_id

string

任意

デプロイメントセットの ID です。

ds-bp1d19mmbsv3jf6xxxxx

rds_instances

array

任意

ApsaraDB RDS インスタンスの ID です。

string

任意

ApsaraDB RDS インスタンスの ID です。

rds-****

private_pool_options

object

任意

プライベートノードプールの設定です。

id

string

任意

プライベートノードプールの ID です。

eap-bp67acfmxazb4****

match_criteria

string

任意

プライベートノードプールのタイプです。このパラメーターは、インスタンスを作成するために使用するプライベートプールのタイプを指定します。プライベートプールは、弾力性保証または容量予約が有効になったときに生成されます。システムはインスタンスを開始するためにプライベートプールを選択します。有効値:

  • Open:オープンなプライベートプールを使用します。システムはインスタンスを開始するためにオープンなプライベートプールを選択します。一致するオープンなプライベートプールが利用できない場合、パブリックプールのリソースが使用されます。

  • Target:指定されたプライベートプールを使用します。システムは指定されたプライベートプールのリソースを使用してインスタンスを開始します。指定されたプライベートプールが利用できない場合、インスタンスは開始できません。

  • None:プライベートプールは使用されません。インスタンスの起動にプライベートプールのリソースは使用されません。

Target

security_group_id deprecated

string

任意

ノードプールを追加したいセキュリティグループの ID です。このパラメーターまたは security_group_ids パラメーターを指定する必要があります。security_group_ids を指定することを推奨します。

sg-wz9a8g2mt6x5llu0****

platform deprecated

string

任意

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

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

デフォルト値:AliyunLinux

null

instance_patterns

array

任意

インスタンスの属性です。

instance_patterns

任意

インスタンスの属性です。

ram_role_name

string

任意

ワーカー RAM ロールの名前です。

  • このパラメーターを指定しない場合、クラスターによって作成されたデフォルトのワーカー RAM ロールが使用されます。

  • 指定された RAM ロールは通常のサービスロールである必要があり、信頼できるサービスの選択パラメーターはElastic Compute Serviceに設定する必要があります。詳細については、「通常のサービスロールの作成」をご参照ください。指定された RAM ロールがクラスターによって作成されたデフォルトのワーカー RAM ロールでない場合、RAM ロールの名前は KubernetesMasterRole- または KubernetesWorkerRole- で始めることはできません。

説明

このパラメーターは、Kubernetes 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 です。このパラメーターは Target パターンのプライベートプール ID のみを受け入れます。N の値の範囲は 1~20 です。

string

任意

プライベートプール ID です。これは弾力性保証サービス ID または容量予約サービス ID です。このパラメーターは Target パターンのプライベートプール ID のみを受け入れます。

eap-bp67acfmxazb4****

system_disk_snapshot_policy_id

string

任意

システムディスクのスナップショットポリシーです。

sp-0jl6xnmme8v7o935****

node_config

object

任意

ノードの設定です。

kubelet_configuration kubelet_config

任意

kubelet の設定です。

kubernetes_config

object

任意

クラスターの設定です。

labels

array

任意

クラスター内のノードに追加したいラベルです。

tag

任意

ラベルの設定です。

taints

array

任意

Taint の設定です。

taint

任意

Taint 設定のコレクションです。

runtime

string

任意

コンテナランタイムの名前です。ACK がサポートするランタイムのタイプは次のとおりです:

  • containerd:containerd は推奨されるランタイムであり、すべての Kubernetes バージョンをサポートします。

  • Sandboxed-Container.runv:Sandbox-Container ランタイムは改善された隔離を提供し、Kubernetes 1.24 以前をサポートします。

  • docker:Docker ランタイムは Kubernetes 1.22 以前をサポートします。

デフォルト値:containerd。

containerd

runtime_version

string

任意

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

1.6.38

cpu_policy

string

任意

ノードプール内のノードの CPU 管理ポリシーです。クラスターの Kubernetes バージョンが 1.12.6 以降の場合、次のポリシーがサポートされます:

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

  • none:デフォルトの CPU アフィニティが使用されることを指定します。

デフォルト値:none

none

user_data

string

任意

ノードのユーザー定義データです。ノードが初期化された後に自動的に実行されるカスタムスクリプトを指定できます。

dGhpcyBpcyBhIGV4YW1wbGU=

unschedulable

boolean

任意

スケールアウト操作が実行された後、ノードがスケジューリング可能かどうかを指定します。

true

cms_enabled

boolean

任意

ECS ノードに CloudMonitor エージェントをインストールするかどうかを指定します。ECS ノードに CloudMonitor エージェントをインストールすると、CloudMonitor コンソールでインスタンスのモニタリング情報を表示できます。CloudMonitor エージェントをインストールすることを推奨します。有効値:

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

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

デフォルト値:false

false

node_name_mode

string

任意

カスタムノード名は、プレフィックス、ノード IP アドレス、サフィックスで構成されます。

  • プレフィックスとサフィックスは、ピリオド (.) で区切られた複数の部分を含むことができます。各部分は小文字、数字、ハイフン (-) を含むことができます。カスタムノード名は、数字または小文字で開始および終了する必要があります。

  • カスタムノード名内のノード IP アドレスは、ノードのプライベート IP アドレスです。

パラメーターを customized,aliyun,ip,com の形式で設定します。値はコンマ (,) で区切られた 4 つの部分で構成されます。customized と ip は固定コンテンツです。aliyun はプレフィックス、com はサフィックスです。例:aliyun.192.168.xxx.xxx.com。

aliyun.com192.XX.YY.55test

pre_user_data

string

任意

ノードのユーザー定義データです。ノードが初期化される前に自動的に実行されるカスタムスクリプトを指定できます。

dGhpcyBpcyBhIGV4YW1wbGU

tee_config

object

任意

クラスターのコンフィデンシャルコンピューティングの設定です。

tee_enable

boolean

任意

クラスターのコンフィデンシャルコンピューティングを有効にするかどうかを指定します。

true

interconnect_config deprecated

object

任意

このパラメーターは非推奨です。

エッジノードプールの設定です。

cen_id

string

任意

このパラメーターは非推奨です。

拡張エッジノードプールに関連付けられている Cloud Enterprise Network (CEN) インスタンスの ID です。

null

ccn_id

string

任意

このパラメーターは非推奨です。

拡張エッジノードプールに関連付けられているクラウド相互接続ネットワーク (CCN) インスタンスの ID です。

null

ccn_region_id

string

任意

このパラメーターは非推奨です。

拡張エッジノードプールに関連付けられている CCN インスタンスが属するリージョンです。

null

bandwidth

integer

任意

このパラメーターは非推奨です。

拡張エッジノードプールの帯域幅です。単位:Mbit/s。

null

improved_period

string

任意

このパラメーターは非推奨です。

拡張エッジノードプールのサブスクリプション期間です。期間は月単位で測定されます。

null

count deprecated

integer

任意

このパラメーターは非推奨です。代わりに desired_size パラメーターを使用してください。

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

null

max_nodes deprecated

integer

任意

このパラメーターは非推奨です。

エッジノードプールに含めることができるノードの最大数です。

null

interconnect_mode

string

任意

エッジノードプールのネットワークタイプです。このパラメーターは、ノードプールの typeedge に設定されている場合にのみ有効になります。有効値:

  • basic:インターネット。

  • private:プライベートネットワーク。

basic

host_network

boolean

任意

Pod のネットワークタイプをホストネットワークに設定するかどうかを指定します。

  • true:ホストネットワークに設定します。

  • false:コンテナネットワークに設定します。

true

intranet

boolean

任意

エッジノードプール内のすべてのノードがレイヤー 3 で相互に通信できるかどうかを指定します。

  • true:エッジノードプール内のノードはレイヤー 3 で相互に通信できます。

  • false:エッジノードプール内のノードはレイヤー 3 で相互に通信できません。

true

eflo_node_group

object

任意

Lingjun ノードプールの設定です。

cluster_id

string

任意

Lingjun ノードプールを作成する際に連携する必要がある Lingjun クラスター ID です。

i1169130516633730****

group_id

string

任意

Lingjun ノードプールを作成する際に連携する Lingjun クラスター内の Lingjun グループの ID です。

ng-ec3c96ff0aa****

auto_mode

object

任意

ノードプールのインテリジェントマネージド設定です。

enable

boolean

任意

インテリジェントマネージドモードを有効にするかどうか。
有効値:

  • true:インテリジェントマネージドモードを有効にします。これは、クラスターでインテリジェントマネージドモードが有効になっている場合にのみ有効にできます。

  • false:インテリジェントマネージドモードを無効にします。

true

node_components

array<object>

任意

エッジゾーンウィジェットのリストです。

array<object>

任意

エッジゾーンウィジェットです。

name

string

任意

エッジゾーンウィジェットの名前です。

kubelet

version

string

任意

エッジゾーンウィジェットのバージョンです。

1.33.3-aliyun.1

config

object

任意

エッジゾーンウィジェットの設定です。

custom_config

object

任意

エッジゾーンウィジェットのカスタム設定です。

string

任意

エッジゾーンウィジェットのカスタム設定文字列です。

cpuManagerPolicy

レスポンスフィールド

フィールド

説明

object

ノードプールの設定です。

nodepool_id

string

ノードプール ID です。

np31da1b38983f4511b490fc62108a****

task_id

string

タスク ID です。

T-613b19bbd160ad492800****

request_id

string

リクエスト ID です。

0527ac9a-c899-4341-a21a-****

成功レスポンス

JSONJSON

{
  "nodepool_id": "np31da1b38983f4511b490fc62108a****",
  "task_id": "T-613b19bbd160ad492800****",
  "request_id": "0527ac9a-c899-4341-a21a-****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。