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

ENS:ModifyClusterNodePool

最終更新日:Sep 22, 2026

クラスターノードプール内のノード構成 (kubelet 構成やノードローテーション構成など) を変更します。ノード構成を変更すると、ノード構成が変更され、kubelet がバッチで再起動されるため、ノードの操作やワークロードの実行に影響を与える可能性があります。この操作はオフピーク時に実行してください。

操作説明

  • 単一ユーザーの呼び出し周波数: 1 秒あたり 10 回。

  • クラスターの作成は非同期操作です。API 呼び出しが返された後、クラスターの初期化が完了するまで 10 ~ 20 分間待機します。このプロセス中に、DescribeClustersV1 操作を呼び出してクラスターの作成ステータスをクエリします。クラスターの作成後、DescribeClusterUserKubeconfig 操作を呼び出してクラスター証明書を取得します。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ens:ModifyClusterNodePool

update

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ClusterId

string

必須

クラスターの ID。

eck- プレフィックスを持つ ECK クラスター ID のみがサポートされています。この ID は、DescribeClustersV1 操作の呼び出しにより取得できます。DescribeCluster 操作によって返されるサーバーレスクラスター ID はサポートされていません。クラスターは実行中状態である必要があります。作成後、初期化が完了するまで通常 10 ~ 20 分かかります。

eck-xxxxxxxx

NodepoolInfo

object

必須

ノードプール情報。

NodepoolId

string

必須

ノードプールの ID。

np68mi5y1dd748ky37ojo2kqdrz

ScalingGroup

object

任意

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

Password

string

任意

インスタンスのパスワード。このパラメーターは key_pair_name と相互排他です。

@AN5Ejx1YyzzK

KeyPairName

string

任意

インスタンスのキーペア。このパラメーターはパスワードと相互排他です。

tf-testAcc

VswitchIds

array

任意

インスタンスが使用する vSwitch。

string

任意

クラスターノードが属する vSwitch の ID。vswitch_ids の ENS リージョンは、ens_region_id の値と同じである必要があります。

vsw-58eu2p6v64qw8ihhit1wz7wgv

InstanceChargeType

string

任意

インスタンスの課金タイプ。

PostPaid

InstanceTypes

array

任意

インスタンスタイプ。

string

任意

インスタンスタイプ。

ens.sn1.small

SystemDiskCategory

string

任意

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

cloud_efficiency

SystemDiskSize

integer

任意

システムクラウドディスクサイズ。

80

ImageId

string

任意

インスタンスイメージの ID。

m-68bysm5a8gkm7oik7ngacf0in

DataDisks

array<object>

任意

データクラウドディスク情報。

object

任意

データクラウドディスク情報。

Category

string

任意

データクラウドディスクタイプ。

cloud_efficiency

Size

integer

任意

データクラウドディスクサイズ。

40

KubernetesConfig

object

任意

Kubernetes の構成。

PreUserData

string

任意

インスタンス作成後かつクラスター参加前に実行するスクリプト。内容は Base64 エンコードされている必要があります。

ZWNobyBvawo=

UserData

string

任意

インスタンス作成後かつクラスター参加後に実行するスクリプト。内容は Base64 エンコードされている必要があります。

ZWNobyBvawo=

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスのスキーマ。

RequestId

string

リクエストの ID。

C0003E8B-B930-4F59-ADC0-0E209A9012A8

例

成功レスポンス

JSONJSON

{
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
}

エラーコード

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

変更履歴

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