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

Container Service for Kubernetes:CreateClusterNodePool

最終更新日:Jul 15, 2026

クラスターのノードプールを作成します。ノードプールは、同じ属性を共有するノードの論理的なコレクションであり、ノードのアップグレードや弾力的スケーリングなどの統一された管理と運用が可能です。さらに、OS の CVE 脆弱性の自動パッチ適用、障害ノードの自動復旧、kubelet および containerd バージョンの自動アップグレードなど、ノードプールの自動化された O&M 機能を活用して、O&M コストを削減できます。

今すぐお試しください

この 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: 標準ノードプール (マネージド機能と自動弾力的スケーリングを含む)。

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

  • lingjun: Lingjun ノードプール。

  • hybrid: ハイブリッドクラウドノードプール。

列挙値:

  • lingjun :

    Lingjun ノードプール。

  • edge :

    エッジノードプール。

  • ess :

    標準ノードプール。

ess

resource_group_id

string

任意

ノードプールのリソースグループ ID。ノードプールによって作成されたインスタンスは、このリソースグループに属します。

リソースは 1 つのリソースグループにのみ属することができます。ビジネスシナリオに応じて、リソースグループをプロジェクト、アプリケーション、組織などの概念にマッピングできます。

rg-acfmyvw3wjmb****

auto_scaling

object

任意

自動弾力的スケーリングの設定。

enable

boolean

任意

自動スケーリングを有効にするかどうかを指定します。有効な値:

  • true: ノードプールの自動スケーリング機能を有効にします。クラスターの容量計画がアプリケーション Pod のスケジューリング要件を満たせない場合、ACK は設定された最小および最大インスタンス数に基づいてノードリソースを自動的にスケーリングします。バージョン 1.24 以降のクラスターでは、デフォルトで即時ノード弾力性が有効になります。1.24 より前のバージョンのクラスターでは、デフォルトでノード auto scaling が有効になります。詳細については、「ノードスケーリング」を参照してください。

  • false: 自動スケーリングを無効にします。ACK は、設定された希望ノード数に基づいてノードプール内のノード数を調整し、ノード数を希望値に維持します。

値が false の場合、auto_scaling 内の他の設定パラメーターは効果がありません。

デフォルト値: false

false

type

string

任意

自動弾力的スケーリングのインスタンスタイプ。このパラメーターは enable=true の場合にのみ効果があります。有効な値:

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

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

  • gpushare: GPU 共有タイプ。

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

デフォルト値: cpu

重要 このフィールドは、ノードプールの作成後に変更できません。

列挙値:

  • spot :

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

  • cpu :

    通常インスタンスタイプ。

  • gpushare :

    GPU 共有タイプ。

  • gpu :

    GPU インスタンスタイプ。

cpu

max_instances

integer

任意

ノードプールでスケーリング可能なインスタンスの最大数 (既存のインスタンスを除く)。このパラメーターは enable=true の場合にのみ効果があります。

有効な値: [min_instances, 2000]。デフォルト値: 0。

10

min_instances

integer

任意

ノードプールでスケーリング可能なインスタンスの最小数 (既存のインスタンスを除く)。このパラメーターは enable=true の場合にのみ効果があります。

有効な値: [0, max_instances]。デフォルト値: 0。

説明
  • 最小インスタンス数が 0 でない場合、スケーリンググループは有効化後に該当する数の ECS インスタンスを自動作成します。

  • 最大インスタンス数の設定は、ノードプール内の現在のノード数以上である必要があります。そうでない場合、弾力的スケーリング機能は有効化後にノードプール内でノードのスケールインを引き起こします。

1

is_bond_eip deprecated

boolean

任意

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

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

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

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

デフォルト値: false

null

eip_internet_charge_type deprecated

string

任意

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

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

  • PayByBandwidth: 帯域幅課金。

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

デフォルト値: PayByBandwidth

null

eip_bandwidth deprecated

integer

任意

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

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

null

management

object

任意

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

enable

boolean

任意

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

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

  • false: マネージド機能を無効にします。その他の関連設定は enable=true の場合にのみ効果があります。

デフォルト値: false。

false

auto_repair

boolean

任意

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

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

  • false: ノードを自動的に修復しません。

デフォルト値: true

true

auto_repair_policy

object

任意

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

restart_node

boolean

任意

ノードの再起動を許可するかどうかを指定します。このパラメーターは auto_repair=true の場合にのみ効果を持ちます。有効な値:

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

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

デフォルト値: true

true

approval_required

boolean

任意

ノード修復に手動承認が必要かどうかを指定します。

auto_vul_fix

boolean

任意

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

  • true: 自動 CVE 修復を許可します。

  • false: 自動 CVE 修復を許可しません。

デフォルト値: true

true

auto_vul_fix_policy

object

任意

自動 CVE 修復ポリシー。

restart_node

boolean

任意

ノードの再起動を許可するかどうかを指定します。このパラメーターは auto_vul_fix=true の場合にのみ効果を持ちます。有効な値:

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

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

デフォルト値: true

false

vul_level

string

任意

自動修正が許可される脆弱性レベル (カンマ区切り)。例: asap,later。サポートされている脆弱性レベル:

  • asap: 高

  • later: 中間

  • nntf: 低

デフォルト値: asap

asap,nntf

exclude_packages

string

任意

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

デフォルト値: kernel

kernel

auto_upgrade

boolean

任意

ノードを自動的にアップグレードするかどうかを指定します。このパラメーターは enable=true の場合にのみ効果があります。

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

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

デフォルト値: true

true

auto_upgrade_policy

object

任意

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

auto_upgrade_kubelet

boolean

任意

kubelet の自動アップグレードを許可するかどうかを指定します。このパラメーターは auto_upgrade=true の場合にのみ効果を持ちます。有効な値:

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

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

デフォルト値: true

true

auto_upgrade_runtime

boolean

任意

ランタイムの自動アップグレードを許可するかどうかを指定します。このパラメーターは auto_upgrade=true の場合にのみ効果を持ちます。有効な値:

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

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

デフォルト値: true

false

auto_upgrade_os

boolean

任意

オペレーティングシステムの自動アップグレードを許可するかどうかを指定します。このパラメーターは auto_upgrade=true の場合にのみ効果を持ちます。有効な値:

  • true: オペレーティングシステムの自動アップグレードを許可します。

  • false: オペレーティングシステムの自動アップグレードを許可しません。

デフォルト値: false

false

upgrade_config deprecated

object

任意

[非推奨] 代わりに上位レベルの auto_upgrade パラメーターを使用してください。

自動アップグレードの設定。このパラメーターは enable=true の場合にのみ効果があります。

auto_upgrade deprecated

boolean

任意

[非推奨] 代わりに上位レベルの auto_upgrade パラメーターを使用してください。

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

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

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

null

surge

integer

任意

追加ノードの数。このパラメーターまたは surge_percentage のいずれかを指定します。

アップグレード中はノードが使用できなくなります。クラスターのワークロードを補うために、追加ノードを作成できます。

説明

追加ノードの数は、現在のノード数を超えないようにしてください。

0

surge_percentage

integer

任意

追加ノードの割合。このパラメーターまたは surge のいずれかを指定します。

追加ノード数 = 追加ノードの割合 × ノード数。たとえば、追加ノードの割合が 50% に設定されており、既存のノードが 6 つある場合、追加ノード数 = 50% × 6 = 3 となります。

0

max_unavailable

integer

任意

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

デフォルト値: 1。

1

auto_fault_diagnosis

boolean

任意

drift_enabled

boolean

任意

scaling_group

object

任意

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

vswitch_ids

array

必須

vSwitch ID のリスト。有効な値: [1,8]。

説明

高可用性を確保するために、異なるゾーンの 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

任意

インスタンスあたりの最大値価格。

単位: USD/時間。

0.39

image_type

string

任意

オペレーティングシステムイメージのタイプ。有効な値:

  • AliyunLinux: Alinux2 イメージ。

  • AliyunLinuxSecurity: Alinux2 UEFI イメージ。

  • AliyunLinux3: Alinux3 イメージ。

  • AliyunLinux3Arm64: Alinux3 ARM イメージ。

  • AliyunLinux3Security: Alinux3 UEFI イメージ。

  • CentOS: CentOS イメージ。

  • Windows: Windows イメージ。

  • WindowsCore: WindowsCore イメージ。

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

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

AliyunLinux3

image_id

string

任意

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

aliyun_2_1903_x64_20G_alibase_20200529.vhd

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

任意

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

string

任意

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

有効な値:

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

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

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

  • cloud_essd_entry: ESSD Entry ディスク。

cloud_essd

system_disk_size

integer

任意

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

有効な値: [20,2048]。

120

system_disk_performance_level

string

任意

ノードのシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクにのみ効果があります。パフォーマンスレベルはクラウドディスクのサイズに関連しています。詳細については、「ESSD クラウドディスク」を参照してください。

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

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

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

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

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: バースト機能を無効にします。

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

true

system_disk_provisioned_iops

integer

任意

システムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。

有効な値: 0~min{50,000, 1000*capacity-baseline performance}。ベースラインパフォーマンス=min{1,800+50*capacity, 50000}。

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

1000

data_disks

array

任意

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

data_disk

任意

データクラウドディスクの構成。

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 とは相互排他です。

説明

ノードプールが ContainerOS オペレーティングシステムを使用している場合、key_pair のみがサポートされます。

np-key-name

login_password

string

任意

SSH ログインパスワード。key_pair とは相互排他です。パスワードの長さは 8〜30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。

****

login_as_non_root

boolean

任意

非ルートユーザーとして ECS インスタンスにログインするかどうかを指定します。

  • true: 非ルートユーザー (ecs-user) としてログインします。

  • false: ルートユーザーとしてログインします。

true

cis_enabled deprecated

boolean

任意

[非推奨] 代わりに security_hardening_os パラメーターを使用してください。

null

soc_enabled

boolean

任意

MLPS 2.0 セキュリティ強化を有効にするかどうかを指定します。この機能は、システムイメージが Alibaba Cloud Linux 2 または Alibaba Cloud Linux 3 の場合にのみ利用可能です。Alibaba Cloud は、Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3 の MLPS 2.0 Level 3 イメージに対して、等級保護コンプライアンスベースラインチェック基準とスキャンプログラムを提供しています。

false

security_hardening_os

boolean

任意

Alibaba Cloud OS セキュリティ強化を有効にするかどうかを指定します。有効な値:

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

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

デフォルト値: false

false

internet_charge_type

string

任意

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

  • PayByBandwidth: 帯域幅課金。

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

PayByTraffic

internet_max_bandwidth_out

integer

任意

ノードの最大アウトバウンドパブリック帯域幅。単位: 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

任意

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

ノードプールが維持すべきノードの総数。クラスターコンポーネントが正常に動作するように、少なくとも 2 つのノードを設定することを推奨します。希望ノード数を調整することで、ノードプールのスケールインまたはスケールアウトが可能です。

ノードを作成する必要がない場合は、この値を 0 に設定し、後で手動で調整してノードを追加してください。

0

multi_az_policy

string

任意

マルチゾーンスケーリングポリシー。

COST_OPTIMIZED

scaling_policy

string

任意

スケーリンググループのパターン。有効な値:

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

  • recycle: Swift パターン。スケーリングのためにインスタンスが作成、停止、開始され、スケーリング速度が向上します。停止中のインスタンスには計算リソースの料金は発生しませんが、ローカルディスクを持つインスタンスを除き、ストレージ料金は引き続き適用されます。

デフォルト値: 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

任意

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

5

spot_instance_remedy

boolean

任意

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

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

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

false

compensate_with_on_demand

boolean

任意

`

true

deploymentset_id

string

任意

デプロイメントセットの ID。デプロイメントセットを使用して、ノードプールによってスケールアウトされた ECS インスタンスを異なる物理サーバーに分散配置し、高可用性と基盤となるディザスタリカバリを確保できます。デプロイメントセット内で ECS インスタンスが作成されると、事前設定されたデプロイ戦略に基づいて指定されたリージョンで起動されます。

重要 デプロイメントセットを選択すると、ノードプール内の最大ノード数が制限されます。デプロイメントセットでサポートされるデフォルトの最大ノード数は、20 × ゾーン数 (ゾーン数は vSwitch によって決定されます) です。慎重に選択し、ノードのスケールアウト失敗を

ds-bp1d19mmbsv3jf6xxxxx

rds_instances

array

任意

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

string

任意

RDS インスタンスの ID。 [parameters.1.schema

rds-****

private_pool_options

object

任意

The private node pool configuration.

id

string

任意

The private node pool ID. When match_criteria is set to Target, you must specify the private pool ID.

eap-bp67acfmxazb4****

match_criteria

string

任意

The private node pool type. Specifies the private pool capacity option for instance launch. After an elasticity assurance or capacity reservation takes effect, a private pool is generated for instance launch. Valid values:

  • Open: Open mode. Automatically matches open-type private pool capacity. If no matching private pool capacity is available, public pool resources are used.

  • Target: Targeted mode. Uses the specified private pool capacity to launch instances. If the specified private pool capacity is unavailable, instance launch fails.

  • None: None mode. Instance launch does not use private pool capacity.

Target

security_group_id deprecated

string

任意

The security group ID of the node pool. Use either this parameter or security_group_ids. We recommend that you use security_group_ids.

sg-wz9a8g2mt6x5llu0****

platform deprecated

string

任意

[This field is deprecated] Use the image_type parameter instead.

The operating system distribution. Valid values:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

Default value: AliyunLinux.

null

instance_patterns

array

任意

The instance attribute configuration.

instance_patterns

任意

The instance attributes.

ram_role_name

string

任意

The Worker RAM role name.

  • If left empty, the default Worker RAM role created by the cluster is used.

  • If specified, the RAM role must be a normal service role with its trusted service configured as Elastic Compute Service. For more information, see Create a normal service role. If the specified RAM role is not the default Worker RAM role created by the cluster, the role name cannot start with KubernetesMasterRole- or KubernetesWorkerRole-.

重要 Only ACK managed clusters of version 1.22 or later support this parameter.

example-role

instance_metadata_options InstanceMetadataOptions

任意

The ECS instance metadata access configuration.

resource_pool_options

object

任意

The resource pool and resource pool strategy used when creating instances. Note the following when you set this parameter: This parameter takes effect only when creating pay-as-you-go instances. This parameter cannot be set together with private_pool_options.match_criteria or private_pool_options.id.

strategy

string

任意

The resource pool strategy used when creating instances. Resource pools include private pools generated after elasticity assurance or capacity reservation takes effect, and public pools for instance launch. Valid values: PrivatePoolFirst: Private pool first. When resouce_pool_options.private_pool_ids is specified, the specified private pools are used first. If no private pool is specified or the specified private pool capacity is insufficient, open-type private pools are automatically matched. If no matching private pool is available, public pool resources are used. PrivatePoolOnly: Private pool only. You must specify resouce_pool_options.private_pool_ids. If the specified private pool capacity is insufficient, instance launch fails. None: Do not use resource pool strategy. Default value: None.

PrivatePoolFirst

private_pool_ids

array

任意

The list of private pool IDs, which are elasticity assurance IDs or capacity reservation IDs. Only Target mode private pool IDs can be specified. Valid values of N: 1 to 20.

string

任意

The private pool ID, which is the elasticity assurance ID or capacity reservation ID. Only Target mode private pool IDs can be specified.

eap-bp67acfmxazb4****

system_disk_snapshot_policy_id

string

任意

The system cloud disk snapshot policy.

sp-0jl6xnmme8v7o935****

disk_init

array

任意

The block device initialization configuration.

DiskInit

任意

The DiskInit configuration.

node_config

object

任意

The node configuration.

kubelet_configuration kubelet_config

任意

The Kubelet parameter settings.

kubernetes_config

object

任意

The cluster-related configuration.

labels

array

任意

The node labels. Adds labels to Kubernetes cluster nodes.

tag

任意

The label configuration.

taints

array

任意

The taint configuration.

taint

任意

The taint configuration set.

runtime

string

任意

The container runtime name. ACK supports the following three container runtimes:

  • containerd: Recommended. Supports all cluster versions.

  • Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supports cluster versions 1.31 and earlier.

  • docker: No longer maintained. Supports cluster versions 1.22 and earlier.

Default value: containerd.

containerd

runtime_version

string

任意

The container runtime version.

1.6.38

cpu_policy

string

任意

The node CPU management policy. The following two policies are supported for cluster versions 1.12.6 and later:

  • static: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.

  • none: Enables the existing default CPU affinity scheme.

Default value: none.

none

user_data

string

任意

The instance user data. After the node joins the cluster, the specified instance user data script is executed. For more information, see User-Data scripts.

dGhpcyBpcyBhIGV4YW1wbGU=

unschedulable

boolean

任意

Specifies whether the scaled-out nodes are unschedulable.

  • true: Unschedulable.

  • false: Schedulable.

true

cms_enabled

boolean

任意

Specifies whether to install CloudMonitor on ECS nodes. After installation, you can view monitoring information of the created ECS instances in the CloudMonitor console. We recommend that you enable this feature. Valid values:

  • true: Installs CloudMonitor on ECS nodes.

  • false: Does not install CloudMonitor on ECS nodes.

Default value: false.

false

node_name_mode

string

任意

The custom node name. After you customize the node name, the node name, ECS instance name, and ECS instance hostname are all changed.

説明

For Windows instances with custom node names enabled, the hostname is fixed to the IP address with hyphens (-) replacing the dots (.) in the IP address, and does not include the prefix or suffix.

The node name consists of a prefix, the node IP address, and a suffix:

  • The total length is 2 to 64 characters. The node name must start and end with a lowercase letter or digit.

  • The prefix and suffix can contain uppercase and lowercase letters, digits, hyphens (-), and periods (.). They must start with an uppercase or lowercase letter and cannot start or end with a hyphen (-) or period (.). Consecutive hyphens (-) or periods (.) are not allowed.

  • The prefix is required (ECS restriction). The suffix is optional.

  • The node IP is the full private IP address of the node.

For example, if the node IP address is 192.XX.YY.55, the prefix is aliyun.com, and the suffix is test:

  • For Linux nodes, the node name, ECS instance name, and ECS instance hostname are all aliyun.com192.XX.YY.55test.

  • For Windows nodes, the ECS instance hostname is 192-XX-YY-55, and the node name and ECS instance name are both aliyun.com192.XX.YY.55test.

aliyun.com192.XX.YY.55test

pre_user_data

string

任意

The instance pre-custom data. Before the node joins the cluster, the specified pre-custom data script is executed. For more information, see User-Data scripts.

dGhpcyBpcyBhIGV4YW1wbGU

tee_config

object

任意

The confidential computing cluster configuration.

tee_enable

boolean

任意

Specifies whether to enable confidential computing for the cluster.

  • true: Enables confidential computing.

  • false: Does not enable confidential computing.

true

interconnect_config deprecated

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.

null

ccn_id

string

任意

[This field is deprecated]

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

null

ccn_region_id

string

任意

[This field is deprecated]

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

null

bandwidth

integer

任意

[This field is deprecated]

The network bandwidth of the enhanced edge node pool. Unit: Mbps.

null

improved_period

string

任意

[This field is deprecated]

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

null

count deprecated

integer

任意

[This field is deprecated] Use desired_size instead.

The number of nodes in the node pool.

null

max_nodes deprecated

integer

任意

[This field is deprecated]

The maximum number of nodes allowed in the edge node pool.

null

interconnect_mode

string

任意

The network type of the edge node pool. This parameter takes effect only for node pools with type set to edge. Valid values:

  • basic: Public network. Nodes in cloud node pool interact with cloud nodes over the Internet. Applications in cloud node pool cannot directly access the cloud VPC internal network.

  • private: Private network. Nodes in cloud node pool connect to the cloud through Express Connect, VPN, or CEN, providing higher cloud-edge communication quality and more effective security.

basic

host_network

boolean

任意

Specifies whether the pod network mode uses host network mode.

  • true: Host network. Pods directly use the host network stack and share the IP address and ports with the host.

  • false: Container network. Pods have independent network stacks and do not occupy host network ports.

true

intranet

boolean

任意

Specifies whether nodes in the edge node pool have Layer 3 network connectivity with each other.

  • true: Connected. All nodes in the node pool have Layer 3 network connectivity.

  • false: Not connected. All nodes in the node pool do not have Layer 3 network connectivity.

true

eflo_node_group

object

任意

The Lingjun node pool configuration.

cluster_id

string

任意

The Lingjun cluster ID to associate when creating a Lingjun node pool.

i1169130516633730****

group_id

string

任意

The Lingjun group ID of the Lingjun cluster to associate when creating a Lingjun node pool.

ng-ec3c96ff0aa****

auto_attach_enabled

boolean

任意

worker_ram_role_name

string

任意

auto_mode

object

任意

The intelligent managed configuration for the node pool.

enable

boolean

任意

Specifies whether to enable intelligent managed mode. Valid values:

  • true: Enables intelligent managed mode. This can be enabled only when the cluster has intelligent managed mode enabled.

  • false: Does not enable intelligent managed mode.

true

node_components

array<object>

任意

The list of node components.

array<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

レスポンスフィールド

フィールド

説明

object

The node pool configuration.

nodepool_id

string

The node pool ID.

np31da1b38983f4511b490fc62108a****

task_id

string

The task ID.

T-613b19bbd160ad492800****

request_id

string

The request ID.

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

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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