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

Container Service for Kubernetes:DescribeClusterNodePools

最終更新日:Aug 21, 2026

クラスター内のすべてのノードプールのリストを照会します。

操作説明

  • ノードを削除する際は、この API または コンテナサービスコンソール を通じて標準化された操作を実行してください。kubectl delete node を使用して手動でノードを削除しないでください。

  • ノードを直接リリースしたり、ECS または ESS コンソール (または関連 API の呼び出し) でインスタンスを削除したり、サブスクリプションインスタンスの有効期限切れによってノードが受動的にリリースされたりしないようにしてください。これらの場合、ノードは直接停止され、コンテナサービスコンソールから自動的に削除されます。

  • ノードプールに希望するノード数が構成されている場合、ノードプールは対応する構成に基づいて他のインスタンスを自動的にスケールアウトし、ノード数を希望する数に維持します。

  • ノードの削除には Pod の移行が伴い、サービスに影響を与える可能性があります。この操作はオフピーク時に実行してください。操作中に予期しないリスクが発生する場合があります。事前に関連データをバックアップしてください。

  • ノードを削除する際、ACK はドレイン操作を実行します。クラスター内の他のノードに十分なリソースがあることを確認し、アプリケーションポッドがスケジューリングできなくなるのを避けてください。

  • 削除対象のノード上の Pod のノードアフィニティルールとスケジューリングポリシーを確認し、ノード削除後に他のノードで Pod がスケジュール不可にならないようにしてください。

今すぐお試しください

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

get

*Cluster

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

なし なし

リクエスト構文

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

パスパラメーター

パラメーター

型

必須 / 任意

説明

例

ClusterId

string

必須

クラスターの ID。

cc0f87de0b8fb403f86e10e204f83****

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

NodepoolName

string

任意

ノードプール名。

nodepool-test

レスポンスフィールド

フィールド

型

説明

例

object

ノードプールの詳細。

nodepools

array<object>

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

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

region_id

string

リージョン ID。

cn-beijing

created

string

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

2025-04-15T16:33:29.362888807+08:00

updated

string

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

2025-04-15T16:33:32.823+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

auto_scaling

object

auto scaling の構成。

enable

boolean

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

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

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

このパラメーターが false にセットされている場合、auto_scaling 内の他の構成パラメーターは効果が適用されません。

true

type

string

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

  • cpu: スタンダードインスタンスタイプ。

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

  • gpushare: GPU 共有タイプ。

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

cpu

max_instances

integer

既存のインスタンスを除く、ノードプール内のスケーラブルなインスタンスの最大値。

10

min_instances

integer

既存のインスタンスを除く、ノードプール内のスケーラブルなインスタンスの最小値。

2

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

max_parallel_repairing_nodes

string

並列修復の最大値。ノードプール内に large 数の異常なノードが存在する場合、同時に修復できるノードの最大値または割合を指定します。

1

max_unhealthy_nodes_threshold

string

自己修復サーキットブレーカー条件。エラーのあるノードの数または割合がこのしきい値を超えると、自己修復がサーキットブレーカー状態に入り、新しい修復アクションの開始を停止します。

10%

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

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

drift_enabled

boolean

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

scaling_group

object

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

scaling_group_id

string

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

asg-2ze8n5qw4atggut8****

vswitch_ids

array

vSwitch ID のリスト。

string

vSwitch の ID。

vsw-2ze3ds0mdip0hdz8i****

instance_types

array

ノードのインスタンスタイプのリスト。代替として複数のインスタンスタイプを選択できます。ノード作成時、システムは最初のスペックから順にインスタンスの購入を試み、成功するまで続けます。実際に購入されるインスタンスタイプは、在庫の可用性によって異なる場合があります。

ecs.n4.large

string

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

ecs.n4.large

instance_charge_type

string

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

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

  • PostPaid: 従量課金。

PostPaid

period

integer

ノードのサブスクリプション期間。このパラメーターは、instance_charge_type が PrePaid に設定されている場合にのみ有効で、必須です。

  • 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_type が PrePaid に設定されている場合に指定する必要があります。有効な値:

  • Month: 計算ユニット (CU) として月単位で課金されます。

  • Week: 計算ユニット (CU) として週単位で課金されます。

Month

auto_renew

boolean

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

  • true: 自動更新が有効です。

  • false: 自動更新が無効です。

false

auto_renew_period

integer

各自動更新サイクルの期間。有効な値:

  • PeriodUnit=Week: 1, 2, 3。

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

0

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。DescribeKubernetesVersionMetadata を呼び出して、システムでサポートされているイメージをクエリできます。

aliyun_3_x64_20G_alibase_20241218.vhd

system_disk_category

string

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

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

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

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

cloud_efficiency

system_disk_categories

array

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

string

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

有効な値:

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

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

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

標準 SSD

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

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

  • true: 有効。有効にすると、ワークロードの変動による突然のデータ読み取り/書き込み負荷が発生した際、ワークロードが安定するまでクラウドディスクが一時的にパフォーマンスを向上させます。

  • false: 無効。

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

true

system_disk_provisioned_iops

integer

ノードのシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。このパラメーターは、ディスクタイプが cloud_auto の場合に設定されます。

1000

data_disks

array

ノードのデータクラウドディスクの構成 (タイプやサイズなど)。

data_disk

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

disk_init

array

ブロックデバイスの初期化構成。

DiskInit

DiskInit の構成。

security_group_ids

array

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

string

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

sg-2ze1iuk12m2sb4c4****

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

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: トラフィック使用量による課金。

PayByBandwidth

internet_max_bandwidth_out

integer

ノードの最大アウトバウンドパブリック帯域幅(Mbps: メガビット/秒)。有効な値: 1~100。

10

tags

array

ECS インスタンスのタグ。

tag

ノードのタグ。

[{\"key\":\"pkg.E2EClient.ClusterId\",\"value\":\"troopers-\"}]

desired_size

integer

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

2

multi_az_policy

string

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

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

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

    説明

    COST_OPTIMIZED は、スケーリング設定で複数のインスタンスタイプが指定されているか、スポットインスタンスが選択されている場合にのみ効果になります。

  • BALANCE: スケーリンググループで指定された複数のアクティブなゾーン全体に ECS インスタンスを均等に割り当てます。在庫不足によりゾーンのバランスが崩れた場合は、 RebalanceInstances API オペレーションを呼び出してリソースの再バランスを行うことができます。

COST_OPTIMIZED

scaling_policy

string

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

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

  • recycle: 高速モード。インスタンスの作成、停止、開始を行ってスケーリングを実行し、後続のスケーリング操作の速度を向上させます。停止中のインスタンスにはコンピューティングリソースの料金は発生しませんが、ストレージ料金は引き続き適用されます。ローカルディスクインスタンスタイプは対象外です。

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

multi_az_policy が COST_OPTIMIZED にセットされている場合、価格または在庫の理由でスポットインスタンスを作成できないときに、ECS インスタンス数の要件を満たすために従量課金インスタンスの自動作成を許可するかどうかを指定します。有効な値:

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

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

true

enable_high_density_mode

boolean

高密度クラウドディスクモードを有効にするかどうかを指定します。これは、ノードプールがインスタンスタイプを使用している場合にのみサポートされます。有効にすると、システムディスクとデータディスクの合計数は、インスタンスタイプでサポートされる高密度クラウドディスクの最大値を超えません。

false

deploymentset_id

string

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

ds-bp1d19mmbsv3jf6xxxxx

rds_instances

array

RDS インスタンスが指定されている場合、クラスターノードプール内の ECS インスタンスは自動的に RDS ホワイトリストに追加されます。

string

RDS インスタンス。

rm-xxx

private_pool_options

object

非公開プールオプション。

id

string

非公開プール ID。エラスティシティ保証 ID またはキャパシティー予約 ID です。

eap-bp67acfmxazb4****

match_criteria

string

インスタンス起動時の非公開プール容量オプション。エラスティシティ保証またはキャパシティー予約が有効になると、インスタンス起動用の非公開プールが生成されます。有効な値:

  • Open: オープンモード。オープンタイプの非公開プール容量を自動的にマッチングします。一致する非公開プール容量がない場合は、パブリックプールリソースが使用されます。

  • Target: 指定モード。指定された非公開プール容量を使用してインスタンスを起動します。非公開プール容量が利用できない場合、インスタンスの起動は失敗します。

  • None: 未使用。インスタンス起動時に非公開プール容量を使用しません。

Open

security_group_id

string

[非推奨]

ノードプールのセキュリティグループ ID。ノードプールが複数のセキュリティグループに関連付けられている場合、これは security_group_ids の最初の値です。

sg-2ze1iuk12m2sb4c4****

platform

string

[非推奨]

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

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

AliyunLinux

ram_policy

string

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

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

instance_patterns

array

インスタンス属性の構成。

instance_patterns

インスタンスの属性。

ram_role_name

string

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

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

resource_pool_options

object

インスタンス作成時に使用されるリソースプールおよびリソースプールポリシー。

strategy

string

インスタンス作成時に使用されるリソースプールポリシー。有効な値: PrivatePoolFirst: 非公開プール優先。 PrivatePoolOnly: 非公開プール専用。 None: リソースプールポリシーなし。

PrivatePoolFirst

private_pool_ids

array

非公開プール ID のリスト。

string

非公開プール ID。

eap-bp1c1fohub5jccwi****

system_disk_snapshot_policy_id

string

システムクラウドディスクのスナップショットポリシー。

sp-0jl6xnmme8v7o935****

cpu_options

object

CPU の構成オプション。

nested_virtualization

string

入れ子になった仮想化が有効かどうかを指定します。有効な値:

  • disabled: 入れ子になった仮想化が無効です。

  • enabled: 入れ子になった仮想化が有効です。

enabled

node_config

object

ノードの構成。

kubelet_configuration kubelet_config

Kubelet のパラメータ設定。

node_os_config

object

ノードのオペレーティングシステム構成。

hugepage

Hugepage

Hugepage の構成。

kubernetes_config

object

クラスター関連の構成。

labels

array

ノードのタグ。

tag

ラベルの構成。

{}

taints

array

ノードの Taint 情報。Taint と Toleration は連携して作業し、Pod が不適切なノードにスケジューリングされるのを防ぎます。詳細については、「taint-and-toleration」を参照してください。

taint

ノードの Taint 情報。

runtime

string

コンテナランタイム名。ACK は以下の 3 つのコンテナランタイムをサポートしています。

  • containerd: 推奨。すべてのクラスターバージョンをサポートします。

  • Sandboxed-Container.runv: より高い隔離性を提供するサンドボックスコンテナ。バージョン 1.31 以前のクラスターをサポートします。

  • docker: 保守終了。バージョン 1.22 以前のクラスターをサポートします。

containerd

runtime_version

string

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

1.6.38

cpu_policy

string

ノードの CPU 管理ポリシー。バージョン 1.12.6 以降のクラスターでは、以下の 2 つのポリシーがサポートされています。

  • static: ノード上で特定のリソース特性を持つ Pod に、強化された CPU アフィニティと排他性を付与できます。静的ポリシーにより、エラー発生時にも安定した動作が可能です。

  • none: 既存のデフォルト CPU アフィニティスキームを有効にします。

none

user_data

string

ノードプールのカスタムデータ。ノードの初期化後に実行されるスクリプトです。詳細については、「インスタンスユーザーデータの生成」を参照してください。

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****

unschedulable

boolean

スケールアウト時に追加されたノードをスケジュール不可にするかどうかを指定します。

  • true: スケジュール不可。

  • false: スケジュール可能。

true

cms_enabled

boolean

ECS ノードに CloudMonitor エージェントをインストールするかどうかを指定します。インストール後、CloudMonitor コンソールで作成された ECS インスタンスのモニタリング情報をビューで確認できます。この特徴を有効にすることを推奨します。有効な値:

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

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

true

node_name_mode

string

カスタムノード名。

ノード名は、プレフィックス + ノード IP アドレスの部分文字列 + サフィックスの 3 つの部分で構成されます。

  • プレフィックスとサフィックスはどちらも、「.」で区切られた 1 つ以上の部分で構成できます。各部分には小文字、数字、ハイフン (-) を含めることができます。ノード名は小文字または数字で始まり、小文字または数字で終わる必要があります。

  • IP アドレスセグメントの長さは、ノード IP アドレスの末尾から抽出する桁数を指定します。有効な値: 5 ~ 12。

例えば、ノード IP アドレスが 192.168.0.55、プレフィックスが aliyun.com、IP アドレスセグメントの長さが 5、サフィックスが test の場合、ノード名は aliyun.com00055test となります。

aliyun.com192.XX.YY.55test

pre_user_data

string

ノードプールの事前カスタムデータ。ノードの初期化前に実行されるスクリプトです。詳細については、「インスタンスユーザーデータの生成」を参照してください。

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD

tee_config

object

機密コンピューティングの構成。

tee_enable

boolean

クラスターの機密コンピューティングを有効にするかどうかを指定します。有効な値:

  • true: 有効。

  • false: 無効。

false

interconnect_config

object

[非推奨]

エッジノードプールのネットワーク構成。この値は edge タイプのノードプールに対してのみ意味を持ちます。

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

interconnect_mode

string

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

  • basic: パブリックネットワーク。クラウドノードプールのノードはパブリックネットワーク経由でクラウドノードと通信します。クラウドノードプールのアプリケーションはクラウド VPC の内部ネットワークに直接アクセスできません。

  • private: 非公開ネットワーク。クラウドノードプールのノードは Express Connect、VPN、または CEN を通じてクラウドに接続し、より高品質なクラウドエッジ通信とより効果的なセキュリティを提供します。

basic

auto_mode

object

インテリジェントマネージド構成。

enable

boolean

インテリジェントマネージドモードが有効かどうかを示します。

true

node_components

array<object>

ノードコンポーネントのリスト。

array<object>

ノードコンポーネント。

name

string

ノードコンポーネントの名前。

kubelet

version

string

ノードコンポーネントのバージョン。

1.33.3-aliyun.1

config

object

ノードコンポーネントの構成。

custom_config

object

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

{"cpuManagerPolicy":"静的"}

any

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

cpuManagerPolicy

envs

array<object>

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

object

name

string

環境変数の名前。

LOG_LEVEL

value

string

環境変数の値。

info

config_revision

string

ノードコンポーネントのカスタム構成のバージョン番号。

1

eflo_node_group

object

Lingjun ノードグループの情報。

cluster_id

string

Lingjun クラスターの ID。

i113790071760688002461

group_id

string

Lingjun グループの ID。

i128147721760688002463

auto_attach_enabled

boolean

Lingjun ノードプールでノードの自動追加が有効かどうかを示します(効果はありません)。

worker_ram_role_name

string

Lingjun ノードプールで使用される作業用 RAM ロール。

例

成功レスポンス

JSONJSON

{
  "nodepools": [
    {
      "nodepool_info": {
        "nodepool_id": "np615c0e0966124216a0412e10afe0****",
        "name": "default-nodepool",
        "type": "ess",
        "is_default": true,
        "resource_group_id": "rg-acfmyvw3wjm****",
        "region_id": "cn-beijing",
        "created": "2025-04-15T16:33:29.362888807+08:00",
        "updated": "2025-04-15T16:33:32.823+08:00"
      },
      "status": {
        "state": "active",
        "healthy_nodes": 3,
        "initial_nodes": 0,
        "failed_nodes": 0,
        "offline_nodes": 0,
        "removing_nodes": 0,
        "serving_nodes": 3,
        "total_nodes": 3
      },
      "auto_scaling": {
        "enable": true,
        "type": "cpu",
        "max_instances": 10,
        "min_instances": 2,
        "eip_internet_charge_type": "PayByBandwidth",
        "is_bond_eip": true,
        "eip_bandwidth": 5
      },
      "management": {
        "enable": true,
        "auto_repair": true,
        "auto_repair_policy": {
          "restart_node": true,
          "approval_required": false,
          "auto_repair_policy_id": "r-xxxxxxxxx",
          "max_parallel_repairing_nodes": "1",
          "max_unhealthy_nodes_threshold": "10%"
        },
        "auto_vul_fix": true,
        "auto_vul_fix_policy": {
          "restart_node": true,
          "vul_level": "asap,nntf",
          "exclude_packages": "kernel"
        },
        "auto_upgrade": true,
        "auto_upgrade_policy": {
          "auto_upgrade_kubelet": true
        },
        "upgrade_config": {
          "auto_upgrade": true,
          "surge": 5,
          "surge_percentage": 50,
          "max_unavailable": 1
        },
        "auto_fault_diagnosis": false,
        "drift_enabled": false
      },
      "scaling_group": {
        "scaling_group_id": "asg-2ze8n5qw4atggut8****",
        "vswitch_ids": [
          "vsw-2ze3ds0mdip0hdz8i****"
        ],
        "instance_types": [
          "ecs.n4.large"
        ],
        "instance_charge_type": "PostPaid",
        "period": 1,
        "period_unit": "Month",
        "auto_renew": false,
        "auto_renew_period": 0,
        "spot_strategy": "NoSpot",
        "spot_price_limit": [
          {
            "instance_type": "ecs.c6.large",
            "price_limit": "0.39"
          }
        ],
        "image_type": "AliyunLinux3",
        "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
        "system_disk_category": "cloud_efficiency",
        "system_disk_categories": [
          "標準 SSD"
        ],
        "system_disk_size": 120,
        "system_disk_performance_level": "PL1",
        "system_disk_encrypted": false,
        "system_disk_kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "system_disk_encrypt_algorithm": "aes-256",
        "system_disk_bursting_enabled": true,
        "system_disk_provisioned_iops": 1000,
        "data_disks": [
          {
            "category": "cloud_ssd",
            "size": 40,
            "encrypted": "true",
            "kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
            "auto_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
            "performance_level": "PL1",
            "provisioned_iops": 1000,
            "bursting_enabled": true,
            "auto_format": true,
            "file_system": "ext4",
            "mount_target": "/mnt/path1",
            "disk_name": "DataDiskName",
            "device": "/dev/xvdb",
            "snapshot_id": "s-280s7****"
          }
        ],
        "disk_init": [
          {
            "disk_name": "disk0",
            "mkfs_type": "ext4",
            "mount_target": "/mnt/disk0",
            "mount_for_runtime": false,
            "local_disk": false
          }
        ],
        "security_group_ids": [
          "sg-2ze1iuk12m2sb4c4****"
        ],
        "key_pair": "pro-nodepool",
        "login_password": "******",
        "login_as_non_root": true,
        "cis_enabled": false,
        "soc_enabled": false,
        "security_hardening_os": false,
        "internet_charge_type": "PayByBandwidth",
        "internet_max_bandwidth_out": 10,
        "tags": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "desired_size": 2,
        "multi_az_policy": "COST_OPTIMIZED",
        "scaling_policy": "release",
        "on_demand_base_capacity": 0,
        "on_demand_percentage_above_base_capacity": 20,
        "spot_instance_pools": 5,
        "spot_instance_remedy": false,
        "compensate_with_on_demand": true,
        "enable_high_density_mode": false,
        "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
        "rds_instances": [
          "rm-xxx"
        ],
        "private_pool_options": {
          "id": "eap-bp67acfmxazb4****",
          "match_criteria": "Open"
        },
        "security_group_id": "sg-2ze1iuk12m2sb4c4****",
        "platform": "AliyunLinux",
        "ram_policy": "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
        "instance_patterns": [
          {
            "cores": 4,
            "memory": 8,
            "instance_family_level": "EnterpriseLevel",
            "excluded_instance_types": [
              "ecs.c6.large"
            ],
            "min_cpu_cores": 4,
            "max_cpu_cores": 8,
            "min_memory_size": 8,
            "max_memory_size": 16,
            "instance_categories": [
              "General-purpose"
            ],
            "cpu_architectures": [
              "X86"
            ],
            "core": 4,
            "max_price": 2,
            "architectures": [
              "X86"
            ],
            "burst_performance_option": "Exclude",
            "instance_type_families": [
              "ecs.c6"
            ],
            "minimum_eni_quantity": 3,
            "minimum_eni_private_ip_address_quantity": 10,
            "minimum_eni_ipv6_address_quantity": 1,
            "maximum_gpu_amount": 8
          }
        ],
        "ram_role_name": "KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****",
        "resource_pool_options": {
          "strategy": "PrivatePoolFirst",
          "private_pool_ids": [
            "eap-bp1c1fohub5jccwi****"
          ]
        },
        "system_disk_snapshot_policy_id": "sp-0jl6xnmme8v7o935****",
        "cpu_options": {
          "nested_virtualization": "有効"
        }
      },
      "node_config": {
        "kubelet_configuration": {
          "registryPullQPS": 5,
          "registryBurst": 10,
          "eventRecordQPS": 5,
          "eventBurst": 10,
          "kubeAPIQPS": 5,
          "kubeAPIBurst": 10,
          "serializeImagePulls": true,
          "cpuManagerPolicy": "none",
          "evictionHard": {
            "test": "test",
            "test2": 1
          },
          "evictionSoft": {
            "test": "test",
            "test2": 1
          },
          "evictionSoftGracePeriod": {
            "test": "test",
            "test2": 1
          },
          "systemReserved": {
            "test": "test",
            "test2": 1
          },
          "kubeReserved": {
            "test": "test",
            "test2": 1
          },
          "readOnlyPort": 0,
          "maxPods": 110,
          "containerLogMaxSize": "10Mi",
          "containerLogMaxFiles": 5,
          "featureGates": {
            "test": "test",
            "test2": 1
          },
          "allowedUnsafeSysctls": [
            "net.core.somaxconn"
          ],
          "reservedMemory": [
            {
              "numaNode": 0,
              "limits": {
                "memory": "1Gi"
              }
            }
          ],
          "memoryManagerPolicy": "none",
          "cpuCFSQuota": true,
          "cpuCFSQuotaPeriod": "100ms",
          "imageGCHighThresholdPercent": 85,
          "imageGCLowThresholdPercent": 80,
          "podPidsLimit": -1,
          "topologyManagerPolicy": "restricted",
          "clusterDNS": [
            "127.0.xx.xx"
          ],
          "tracing": {
            "endpoint": "localhost:4317",
            "samplingRatePerMillion": 200000
          },
          "containerLogMaxWorkers": 1,
          "containerLogMonitorInterval": "10s",
          "serverTLSBootstrap": true
        },
        "node_os_config": {
          "hugepage": {
            "transparentEnabled": "",
            "transparentDefrag": "",
            "khugepagedDefrag": 0,
            "khugepagedAllocSleepMillisecs": 0,
            "khugepagedScanSleepMillisecs": 0,
            "khugepagedPagesToScan": 0
          }
        }
      },
      "kubernetes_config": {
        "labels": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "taints": [
          {
            "key": "key",
            "value": "value",
            "effect": "NoSchedule"
          }
        ],
        "runtime": "コンテナ",
        "runtime_version": "1.6.38",
        "cpu_policy": "none",
        "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****",
        "unschedulable": true,
        "cms_enabled": true,
        "node_name_mode": "aliyun.com192.XX.YY.55test",
        "pre_user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD"
      },
      "tee_config": {
        "tee_enable": false
      },
      "interconnect_config": {
        "cen_id": "cen-ey9k9nfhz0f*******",
        "ccn_id": "ccn-qm5i0i0q9yi*******",
        "ccn_region_id": "cn-shanghai",
        "bandwidth": 10,
        "improved_period": "1"
      },
      "max_nodes": 10,
      "interconnect_mode": "basic",
      "auto_mode": {
        "enable": true
      },
      "node_components": [
        {
          "name": "kubelet",
          "version": "1.33.3-aliyun.1",
          "config": {
            "custom_config": {
              "key": "cpuManagerPolicy"
            },
            "envs": [
              {
                "name": "LOG_LEVEL",
                "value": "info"
              }
            ]
          },
          "config_revision": "1"
        }
      ],
      "eflo_node_group": {
        "cluster_id": "i113790071760688002461",
        "group_id": "i128147721760688002463",
        "auto_attach_enabled": false,
        "worker_ram_role_name": ""
      }
    }
  ]
}

エラーコード

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

変更履歴

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