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

Container Service for Kubernetes:DescribeClusterNodePoolDetail

最終更新日:Aug 21, 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

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

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

  • false: 弾力的スケーリングを無効にします。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

max_parallel_repairing_nodes

string

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

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

0

period_unit

string

サブスクリプション期間の単位。このパラメーターは、instance_charge_type が PrePaid に設定されている場合に指定する必要があります。

  • Month: 月単位。

  • Week: 週単位。

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。

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。

  • 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 クラウドディスク。

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_category が cloud_auto に設定されている場合にのみサポートされます。詳細については、「ESSD AutoPL クラウドディスク」を参照してください。

true

system_disk_provisioned_iops

integer

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

指定可能な値: 0~min{50,000, 1000×容量-ベースラインパフォーマンス}。ベースラインパフォーマンス=min{1,800+50×容量, 50000}。

このパラメーターは、system_disk_category が cloud_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 の場合にのみ有効にできます。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 アドレスの最大アウトバウンド帯域幅(Mbps:メガビット毎秒)。有効な値: 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 API を使用してリソースの再バランスを実行できます。詳細については、「 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

最小オンデマンド基準容量(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。

eap-bp67acfmxazb4****

match_criteria

string

非公開ノードプールタイプ。インスタンス起動時の非公開プール容量オプションを指定します。エラスティシティ保証またはキャパシティー予約が効果を発揮した後、インスタンス起動選択用に非公開プール容量が生成されます。有効な値:

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

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

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

Open

security_group_id

string

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

sg-2ze60ockeekspl3d****

platform

string

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

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

AliyunLinux

ram_policy

string

[非推奨] 代わりに ram_role_name を使用してください。RAM ロール名。

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

instance_patterns

array

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

instance_patterns

インスタンス属性。

ram_role_name

string

Worker RAM ロール名。

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

instance_metadata_options InstanceMetadataOptions

ECS インスタンスのメタデータアクセス構成。

resource_pool_options

object

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

private_pool_ids

array

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

string

非公開プールの ID。

eap-bp1c1fohub5jccwi****

strategy

string

インスタンス作成時に使用されるリソースプール戦略。有効な値:

  • PrivatePoolFirst: 非公開プール優先。

  • PrivatePoolOnly: 非公開プールのみ。

  • None: リソースプール戦略は使用されません。

PrivatePoolFirst

system_disk_snapshot_policy_id

string

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

sp-bp11g8z59rawcud9****

disk_init

array

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

DiskInit

DiskInit の構成。

cpu_options

object

CPU 関連の構成オプション。

nested_virtualization

string

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

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

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

有効

node_config

object

ノードの構成。

kubelet_configuration kubelet_config

Kubelet のパラメータ設定。

node_os_config

object

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

hugepage

Hugepage

Hugepage の構成。

kubernetes_config

object

クラスター関連の構成。

labels

array

ノードタグ。

tag

ECS タグ。

taints

array

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

taint

ノードの Taint 構成。

runtime

string

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

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

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

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

コンテナ

runtime_version

string

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

1.6.38

cpu_policy

string

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

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

  • none: 既存のデフォルト CPU アフィニティスキームを有効にします。エラーが発生した場合のフォールトトレランス用です。

none

user_data

string

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

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi

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

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

dGhpcyBpcyBhIGV4YW1wbGU

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

[非推奨]

エッジ強化ノードプールのネットワーク帯域幅。単位: Mbit/s。

10

improved_period

string

[非推奨]

エッジ強化ノードプールの購入持続時間。単位: 月。

1

max_nodes

integer

[非推奨]

エッジノードプールで許可される最大ノード数。

10

interconnect_mode

string

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

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

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

basic

host_network

boolean

Pod のネットワークモードがホストネットワークモードを使用するかどうかを指定します。

  • true: ホストネットワーク。Pod はホストのネットワークスタックを直接使用し、ホストと IP アドレスおよびポートを共有します。

  • false: コンテナネットワーク。Pod は独立したネットワークスタックを持ち、ホストのネットワークポートを占有しません。

true

intranet

boolean

エッジノードプール内のノードがレイヤー 3 ネットワーク接続性を持つかどうかを指定します。

  • true: 接続済み。ノードプール内のすべてのノードがレイヤー 3 ネットワーク接続性を持ちます。

  • false: 未接続。ノードプール内のすべてのノードがレイヤー 3 ネットワーク接続性を持ちません。

true

auto_mode

object

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

enable

boolean

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

false

node_components

array<object>

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

array<object>

ノードコンポーネント。

name

string

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

kubelet

version

string

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

1.33.3-aliyun.1

config

object

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

custom_config

object

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

{"cpuManagerPolicy":"static"}

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

{
  "nodepool_info": {
    "nodepool_id": "np615c0e0966124216a0412e10afe0****",
    "name": "default-nodepool",
    "type": "ess",
    "is_default": true,
    "resource_group_id": "rg-acfmyvw3wjmb****",
    "region_id": "cn-beijing",
    "created": "2025-04-10T14:25:37.285530433+08:00",
    "updated": "2025-04-15T15:39:45.41+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,
    "conditions": [
      {
        "type": "ImageUpgradeReady",
        "status": "True",
        "reason": "UpgradeDisabled",
        "message": "AutoUpgradeDisabled",
        "last_transition_time": "20**-**-30T10:39:00+08:00"
      }
    ]
  },
  "auto_scaling": {
    "enable": true,
    "type": "cpu",
    "max_instances": 10,
    "min_instances": 1,
    "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-xxxxxxxxxx",
      "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-2zeieod8giqmov7z****",
    "vswitch_ids": [
      "vsw-2ze3ds0mdip0hdz8i****"
    ],
    "instance_types": [
      "ecs.n4.large"
    ],
    "instance_charge_type": "PostPaid",
    "period": 0,
    "period_unit": "Month",
    "auto_renew": false,
    "auto_renew_period": 1,
    "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": [
      "cloud_essd"
    ],
    "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****"
      }
    ],
    "security_group_ids": [
      "sg-2ze60ockeekspl3d****"
    ],
    "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": "BALANCE",
    "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-2ze60ockeekspl3d****",
    "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****",
    "instance_metadata_options": {
      "http_tokens": "optional"
    },
    "resource_pool_options": {
      "private_pool_ids": [
        "eap-bp1c1fohub5jccwi****"
      ],
      "strategy": "PrivatePoolFirst"
    },
    "system_disk_snapshot_policy_id": "sp-bp11g8z59rawcud9****",
    "disk_init": [
      {
        "disk_name": "disk0",
        "mkfs_type": "ext4",
        "mount_target": "/mnt/disk0",
        "mount_for_runtime": false,
        "local_disk": false
      }
    ],
    "cpu_options": {
      "nested_virtualization": "enabled"
    }
  },
  "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": "containerd",
    "runtime_version": "1.6.38",
    "cpu_policy": "none",
    "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi",
    "unschedulable": true,
    "cms_enabled": true,
    "node_name_mode": "aliyun.com192.XX.YY.55test",
    "pre_user_data": "dGhpcyBpcyBhIGV4YW1wbGU"
  },
  "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",
  "host_network": true,
  "intranet": true,
  "auto_mode": {
    "enable": false
  },
  "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": ""
  }
}

エラーコード

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

変更履歴

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