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

Container Service for Kubernetes:DescribeClusterNodePoolDetail

最終更新日:Jun 25, 2026

ノードプール ID を指定して、クラスター内の指定されたノードプールの構成を照会します。

今すぐお試しください

この 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:DescribeClusterNodePoolDetail

get

*Cluster

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

なし なし

リクエスト構文

GET /clusters/{ClusterId}/nodepools/{NodepoolId} HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

ClusterId

string

必須

クラスター ID。

c23421cfa74454bc8b37163fd19af****

NodepoolId

string

必須

ノードプール ID。

np31da1b38983f4511b490fc62108a****

リクエストパラメーター

パラメーター

必須 / 任意

説明

リクエストパラメーターは必要ありません。

レスポンスフィールド

フィールド

説明

object

ノードプールの詳細。

nodepool_info

object

ノードプールの構成。

nodepool_id

string

ノードプール ID。

np615c0e0966124216a0412e10afe0****

name

string

ノードプール名。

default-nodepool

type

string

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

  • ess: 通常のノードプール (マネージドおよび自動弾力的スケーリングの特徴を含む)。

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

  • lingjun: Lingjun ノードプール。

ess

is_default

boolean

ノードプールがデフォルトのノードプールかどうかを示します。クラスターには通常、デフォルトのノードプールが 1 つだけあります。有効な値:

  • true: デフォルトのノードプールです。

  • false: デフォルトのノードプールではありません。

true

resource_group_id

string

リソースグループ ID。

rg-acfmyvw3wjmb****

region_id

string

リージョン ID。

cn-beijing

created

string

ノードプールが作成された時間。

2025-04-10T14:25:37.285530433+08:00

updated

string

ノードプールが最後に更新された時間。

2025-04-15T15:39:45.41+08:00

status

object

ノードプールのステータス。

state

string

ノードプールのステータス。有効な値:

  • active: ノードプールはアクティブなステータスです。

  • scaling: ノードプールはスケーリング中です。

  • removing: ノードを削除中です。

  • deleting: ノードプールを削除中です。

  • updating: ノードプールを更新中です。

active

healthy_nodes

integer

正常なノードの数。

3

initial_nodes

integer

作成中のノードの数。

0

failed_nodes

integer

失敗したノードの数。

0

offline_nodes

integer

オフラインノードの数。

0

removing_nodes

integer

削除中のノードの数。

0

serving_nodes

integer

サービス提供中のノードの数。

3

total_nodes

integer

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

3

conditions

array<object>

ノードプールの現在の状態。さまざまなディメンションのステータス情報を表します。

object

単一のステータス属性。

type

string

タイプ。

ImageUpgradeReady

status

string

ステータス。

True

reason

string

理由。

UpgradeDisabled

message

string

詳細情報。

AutoUpgradeDisabled

last_transition_time

string

最後のステータストランジションの時間。

20**-**-30T10:39:00+08:00

auto_scaling

object

ノードプールの auto scaling 構成。

enable

boolean

auto scaling を有効にするかどうかを指定します。有効な値:

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

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

このパラメーターが false に設定されている場合、auto_scaling 内の他の構成パラメーターは有効になりません。

true

type

string

インスタンスタイプ別に分類された auto scaling タイプ。有効な値:

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

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

  • gpushare: GPU 共有タイプ。

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

cpu

max_instances

integer

ノードプールでスケーリングできるインスタンスの最大値。既存のインスタンスは含まれません。

10

min_instances

integer

ノードプールでスケーリングできるインスタンスの最小値。既存のインスタンスは含まれません。

1

eip_internet_charge_type

string

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

  • PayByBandwidth: 帯域幅課金。

  • PayByTraffic: データ転送量課金。

PayByBandwidth

is_bond_eip

boolean

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

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

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

true

eip_bandwidth

integer

EIP のピーク帯域幅。

有効な値: [1,100]。単位: Mbit/s。

5

management

object

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

enable

boolean

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

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

  • false: マネージドノードプールを無効にします。その他の関連構成は enable=true の場合にのみ有効になります。

true

auto_repair

boolean

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

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

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

true

auto_repair_policy

object

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

restart_node

boolean

ノードの再起動を許可するかどうかを指定します。このパラメーターは auto_repair=true の場合にのみ効果があります。

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

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

true

approval_required

boolean

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

false

auto_repair_policy_id

string

自動修復ポリシー ID。

r-xxxxxxxxxx

auto_vul_fix

boolean

CVE を自動的に修正するかどうかを指定します。このパラメーターは enable=true の場合にのみ有効になります。

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

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

true

auto_vul_fix_policy

object

CVE 自動修正ポリシー。

restart_node

boolean

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

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

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

true

vul_level

string

自動修正が許可される脆弱性レベル。カンマ区切りです。

  • asap: 高

  • later: 中間

  • nntf: 低。

asap,nntf

exclude_packages

string

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

kernel

auto_upgrade

boolean

ノードの自動スペックアップを有効にするかどうかを指定します。このパラメーターは enable=true の場合にのみ有効になります。

  • true: 自動スペックアップを有効にします。

  • false: 自動スペックアップを無効にします。

true

auto_upgrade_policy

object

自動スペックアップポリシー。

auto_upgrade_kubelet

boolean

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

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

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

true

upgrade_config

object

自動スペックアップ構成。このパラメーターは enable=true の場合にのみ有効になります。

auto_upgrade

boolean

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

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

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

true

surge

integer

追加ノードの数。このパラメーターまたは surge_percentage のいずれかを設定できますが、両方を同時に設定することはできません。

5

surge_percentage

integer

追加ノードの割合。このパラメーターまたは surge のいずれかを設定できますが、両方を同時に設定することはできません。

追加ノード数 = 追加ノード割合 × ノード数。例えば、追加ノード割合が 50% で既存ノードが 6 つの場合、追加ノード数 = 50% × 6 = 3 です。

50

max_unavailable

integer

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

デフォルト値: 1。

1

auto_fault_diagnosis

boolean

scaling_group

object

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

scaling_group_id

string

スケーリンググループ ID。

asg-2zeieod8giqmov7z****

vswitch_ids

array

vSwitch ID のリスト。

string

vSwitch ID。

vsw-2ze3ds0mdip0hdz8i****

instance_types

array

ノードインスタンスタイプのリスト。

string

ノードインスタンスタイプ。

ecs.n4.large

instance_charge_type

string

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

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

  • PostPaid: 従量課金。

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}。

0

period_unit

string

ノードの課金サイクル単位。instance_charge_typePrePaid に設定されている場合にこのパラメーターを指定する必要があります。

  • Month: 単位は月です。

  • Week: 単位は週です。

Month

auto_renew

boolean

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

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

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

false

auto_renew_period

integer

1 回の更新サイクルの自動更新持続時間。有効な値:

  • PeriodUnit=Week の場合: 1, 2, 3。

  • PeriodUnit=Month の場合: 1, 2, 3, 6, 12, 24, 36, 48, 60。

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_3_x64_20G_alibase_20241218.vhd

system_disk_category

string

ノードのシステムクラウドディスクタイプ。有効な値:

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD (エンタープライズ SSD)。

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

  • cloud_essd_entry: ESSD Entry クラウドディスク。

cloud_efficiency

system_disk_categories

array

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

string

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

有効な値:

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD (エンタープライズ SSD)。

  • 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 を参照してください。標準 SSD はパフォーマンスレベルをサポートしていません。

  • 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 × 容量 - ベースラインパフォーマンス}。ベースラインパフォーマンス = min{1,800 + 50 × 容量, 50000}。

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

1000

data_disks

array

データクラウドディスクの構成。ディスクタイプとサイズを含みます。

data_disk

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

security_group_ids

array

ノードプールのセキュリティグループ ID のリスト。

string

ノードプールのセキュリティグループ ID。

sg-2ze60ockeekspl3d****

key_pair

string

キーペア名。このパラメーターまたは login_password を設定できます。マネージドノードプールの場合、key_pair のみがサポートされます。

pro-nodepool

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 パラメーターを使用してください。

false

soc_enabled

boolean

等級保護 2.0 セキュリティ強化を有効にするかどうかを指定します。システムイメージが Alibaba Cloud Linux 2 または Alibaba Cloud Linux 3 の場合にのみ、ノードの等級保護 2.0 セキュリティ強化を有効にできます。Alibaba Cloud は、Alibaba Cloud Linux 2 および Alibaba Cloud Linux 3 の等級保護 2.0 レベル 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: データ転送量課金。

PayByBandwidth

internet_max_bandwidth_out

integer

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

10

tags

array

ECS インスタンスタグ。

tag

ノードタグ。

desired_size

integer

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

2

multi_az_policy

string

マルチゾーンスケーリンググループにおける ECS インスタンスのスケーリングポリシー。有効な値:

  • PRIORITY: 定義した vSwitch (VSwitchIds.N) に基づいてスケーリングします。優先度の高い vSwitch のゾーンで ECS インスタンスを作成できない場合、システムは自動的に次の優先度の vSwitch を使用します。

  • COST_OPTIMIZED: vCPU 単位価格の昇順でインスタンスを作成します。スケーリング設定で複数のインスタンスタイプにスポット課金方法を指定した場合、スポットインスタンスが最初に作成されます。CompensateWithOnDemand パラメーターを使用して、在庫不足によりスポットインスタンスを作成できない場合に従量課金インスタンスを自動的に作成するかどうかを指定できます。

    説明

    COST_OPTIMIZED は、スケーリング設定で複数のインスタンスタイプを指定するか、スポットインスタンスを使用する場合にのみ有効になります。

  • BALANCE: スケーリンググループで指定されたアクティブなゾーン間で ECS インスタンスを均等に分散します。在庫不足によりゾーンが不均衡になった場合、RebalanceInstances 操作を呼び出してリソースを割り当てできます。詳細については、 RebalanceInstances を参照してください。

デフォルト値: PRIORITY

BALANCE

scaling_policy

string

スケーリンググループモード。有効な値:

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

  • recycle: 高速モード。インスタンスの作成、停止、起動によりスケーリングし、後続のスケーリング速度を向上させます。停止されたインスタンスはコンピューティングリソースに対して課金されませんが、ローカルディスクを持つインスタンスを除き、ストレージ料金は引き続き適用されます。

release

on_demand_base_capacity

integer

スケーリンググループで必須の従量課金インスタンスの最小値。有効な値: [0,1000]。従量課金インスタンスの数がこの値

0

on_demand_percentage_above_base_capacity

integer

The percentage of pay-as-you-go instances among the instances that exceed the minimum pay-as-you-go instance count (on_demand_base_capacity). Valid values: [0,100].

20

spot_instance_pools

integer

The number of available instance types. The scaling group creates spot instances across multiple lowest-cost instance types in a balanced manner. Valid values: [1,10].

5

spot_instance_remedy

boolean

Specifies whether to enable spot instance supplementation. When enabled, the scaling group attempts to create new instances to replace spot instances that are about to be reclaimed. Valid values:

  • true: Enable spot instance supplementation.

  • false: Disable spot instance supplementation.

false

compensate_with_on_demand

boolean

When multi_az_policy is set to COST_OPTIMIZED, specifies whether to automatically create pay-as-you-go instances when spot instances cannot be created due to price or inventory reasons. Valid values:

  • true: Allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances.

  • false: Do not allow automatic creation of pay-as-you-go instances.

true

deploymentset_id

string

The deployment set ID.

ds-bp1d19mmbsv3jf6xxxxx

rds_instances

array

The list of RDS instances. If specified, the ECS instances of the cluster nodes are automatically added to the RDS access whitelist.

string

The RDS instance.

rm-xxx

private_pool_options

object

The private pool configuration.

id

string

プライベートプール ID。

eap-bp67acfmxazb4****

match_criteria

string

プライベートプールタイプ。インスタンス起動時のキャパシティオプションを指定します。Elasticity Assurance またはキャパシティ予約が有効になると、インスタンス起動用のプライベートプールが生成されます。有効な値:

  • Open: オープンモード。オープンなプライベートプールキャパシティを自動的にマッチングします。マッチするプライベートプールキャパシティがない場合、パブリックプールリソースが使用されます。

  • Target: ターゲットモード。指定されたプライベートプールキャパシティを使用してインスタンスを起動します。指定されたプライベートプールキャパシティが利用できない場合、インスタンスの起動に失敗します。

  • None: なしモード。インスタンス起動にプライベートプールキャパシティは使用されません。

Open

security_group_id

string

The security group ID of the node pool. When the node pool is associated with multiple security groups, this is the first value in security_group_ids.

sg-2ze60ockeekspl3d****

platform

string

The operating system distribution. Valid values:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore.

AliyunLinux

ram_policy

string

[This field is deprecated] Use ram_role_name instead.

KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****

instance_patterns

array

The instance attribute configurations.

instance_patterns

The instance attributes.

ram_role_name

string

The worker RAM role name.

KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****

instance_metadata_options InstanceMetadataOptions

The metadata access configuration for ECS instances.

resource_pool_options

object

The resource pool and resource pool policy used for instance creation.

private_pool_ids

array

プライベートプール ID のリスト。

string

プライベートプール ID。

eap-bp1c1fohub5jccwi****

strategy

string

インスタンス作成に使用されるリソースプールポリシー。有効な値: PrivatePoolFirst: プライベートプール優先。 PrivatePoolOnly: プライベートプールのみ。 None: リソースプールポリシーなし。

PrivatePoolFirst

system_disk_snapshot_policy_id

string

The snapshot policy for the system cloud disk.

sp-bp11g8z59rawcud9****

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.

node_os_config

object

The node operating system configuration.

hugepage

Hugepage

Hugepage の構成。

kubernetes_config

object

The cluster-related configuration.

labels

array

ノードタグ。

tag

The ECS tag.

taints

array

The node taint information. Taints and tolerations work together to prevent pods from being scheduled to inappropriate nodes. For more information, see taint-and-toleration.

taint

The node taint configuration.

runtime

string

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

  • containerd: recommended. Supported by all cluster versions.

  • Sandboxed-Container.runv: sandboxed container that provides higher isolation. Supported by clusters of version 1.31 and earlier.

  • docker: no longer maintained. Supported by clusters of version 1.22 and earlier.

containerd

runtime_version

string

The container runtime version.

1.6.38

cpu_policy

string

The CPU management policy for nodes. The following two policies are supported for clusters of version 1.12.6 and later:

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

  • none: Uses the existing default CPU affinity scheme.

none

user_data

string

The custom data of the node pool, which is a script that runs after node initialization. For more information, see Generate instance user data.

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi

unschedulable

boolean

Specifies whether the scaled-out nodes are unschedulable.

  • true: Unschedulable.

  • false: Schedulable.

true

cms_enabled

boolean

Specifies whether to install the CloudMonitor agent 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: Install the CloudMonitor agent on ECS nodes.

  • false: Do not install the CloudMonitor agent on ECS nodes.

true

node_name_mode

string

The custom node name.

A node name consists of three parts: prefix + node IP address substring + suffix:

  • The prefix and suffix can each consist of one or more parts separated by ".". Each part can contain lowercase letters, digits, and hyphens (-). The node name must start and end with a lowercase letter or digit.

  • The IP address segment length specifies the number of digits taken from the end of the node IP address. Valid values: 5 to 12.

For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP address segment length is 5, and the suffix is test, the node name is aliyun.com00055test.

aliyun.com192.XX.YY.55test

pre_user_data

string

The pre-initialization custom data of the node pool, which is a script that runs before node initialization. For more information, see Generate instance user data.

dGhpcyBpcyBhIGV4YW1wbGU

tee_config

object

The confidential computing cluster configuration.

tee_enable

boolean

Specifies whether to enable the confidential computing cluster. Valid values:

  • true: Enable.

  • false: Disable.

false

interconnect_config

object

[This field is deprecated]

The network-related configuration for edge node pools. This value is meaningful only for edge-type node pools.

cen_id

string

[This field is deprecated]

The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool.

cen-ey9k9nfhz0f*******

ccn_id

string

[This field is deprecated]

The Cloud Connect Network (CCN) instance ID bound 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 edge-enhanced node pool. Unit: Mbit/s.

10

improved_period

string

[This field is deprecated]

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

1

max_nodes

integer

[This field is deprecated]

The maximum number of nodes that the edge node pool can contain.

10

interconnect_mode

string

The network type of the edge node pool. This parameter takes effect only for node pools whose type is edge. Valid values:

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

  • private: private network. Nodes in cloud node pool connect to the cloud network through Express Connect circuits, VPN, or Cloud Enterprise Network (CEN), which provides higher cloud-edge communication quality and more effective security.

basic

host_network

boolean

Specifies whether the pod network uses host network mode.

  • true: host network. Pods directly use the network stack of the host 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 Layer 3 network connectivity is enabled among nodes in the edge node pool.

  • true: enabled. All nodes in the node pool have Layer 3 network connectivity with each other.

  • false: disabled. All nodes in the node pool do not have Layer 3 network connectivity with each other.

true

auto_mode

object

The intelligent hosting configuration.

enable

boolean

Specifies whether to enable intelligent hosting.

false

node_components

array<object>

The list of node components.

array<object>

The node component.

name

string

The name of the node component.

kubelet

version

string

The version of the node component.

1.33.3-aliyun.1

config

object

The configuration of the node component.

custom_config

object

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

{"cpuManagerPolicy":"static"}

string

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

cpuManagerPolicy

eflo_node_group

object

cluster_id

string

i113790071760688002461

group_id

string

i128147721760688002463

エラーコード

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

変更履歴

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