ModifyClusterNodePool 操作を呼び出して、ノードプール ID に基づいてノードプールの構成を更新します。
操作説明
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cs:ModifyClusterNodePool |
update |
*Cluster
|
なし | なし |
リクエスト構文
PUT /clusters/{ClusterId}/nodepools/{NodepoolId} HTTP/1.1
パスパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClusterId |
string |
必須 |
クラスターの ID。 |
c23421cfa74454bc8b37163fd19af**** |
| NodepoolId |
string |
必須 |
ノードプールの ID。 |
p31da1b38983f4511b490fc62108a**** |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| body |
object |
任意 |
リクエストボディのパラメーター。 |
|
| nodepool_info |
object |
任意 |
ノードプールの構成。 |
|
| name |
string |
任意 |
ノードプールの名前。 命名規則: 名前の長さは 1~63 文字で、数字、漢字、英字、ハイフン (-) を含めることができます。ハイフン (-) で始めることはできません。 |
default-nodepool |
| resource_group_id |
string |
任意 |
ノードプールのリソースグループ ID。ノードプールによってスケールアウトされたインスタンスは、このリソースグループに属します。 |
rg-acfmyvw3wjm**** |
| auto_scaling |
object |
任意 |
auto scaling の構成。 |
|
| enable |
boolean |
任意 |
auto scaling を有効にするかどうかを指定します。有効な値: |
true |
type
deprecated
|
string |
任意 |
インスタンスタイプ別に分類された auto scaling タイプ。有効な値: |
cpu |
| max_instances |
integer |
任意 |
ノードプールでスケールアウトできるインスタンスの最大値 (既存のインスタンスを除く)。このパラメーターは |
10 |
| min_instances |
integer |
任意 |
ノードプール内のスケーラブルなインスタンスの最小数(既存のインスタンスを除く)。このパラメーターは 有効な値: [0, max_instances]。デフォルト値: 0。 説明
|
2 |
is_bond_eip
deprecated
|
boolean |
任意 |
[非推奨] このパラメーターは非推奨です。代わりに internet_charge_type および internet_max_bandwidth_out を使用してください。 |
null |
eip_internet_charge_type
deprecated
|
string |
任意 |
[非推奨] 代わりに internet_charge_type および internet_max_bandwidth_out を使用してください。 |
null |
eip_bandwidth
deprecated
|
integer |
任意 |
[非推奨] 代わりに internet_charge_type および internet_max_bandwidth_out を使用してください。 EIP のピーク帯域幅。 有効な値: [1,100]。単位: Mbit/s。 |
null |
| management |
object |
任意 |
マネージドノードプールの構成。 |
|
| enable |
boolean |
任意 |
マネージドノードプールを有効にするかどうかを指定します。有効な値: |
true |
| auto_repair |
boolean |
任意 |
ノードを自動修復するかどうかを指定します。このパラメーターは
デフォルト値: |
true |
| auto_repair_policy |
object |
任意 |
ノードの自動修復ポリシー。 |
|
| restart_node |
boolean |
任意 |
ノードの再起動を許可するかどうかを指定します。このパラメーターは |
true |
| approval_required |
boolean |
任意 |
ノード修復に手動承認が必要かどうかを指定します。 |
|
| auto_repair_policy_id |
string |
任意 |
自動修復ポリシーの ID。 |
r-xxxxxxxxxx |
| max_parallel_repairing_nodes |
string |
任意 |
並列で修復できるノードの最大数。ノードプール内に多数のエラーのあるノードが存在する場合、このパラメーターは同時に修復できるノードの最大数またはタグの割合を指定します。数値 (例: 5、有効値: 1~100000) またはパーセンテージ (例: 10%、有効値: 1%~100%) を指定できます。デフォルト値: 1。 |
5 |
| max_unhealthy_nodes_threshold |
string |
任意 |
自己修復のサーキットブレーカー条件。エラーのあるノードの数またはタグの割合がこのしきい値を超えると、自己修復はサーキットブレーカー状態に入り、新しい修復アクションの開始を停止します。数値 (例: 10、有効値: 1~100000) またはパーセンテージ (例: 20%、有効値: 1%~100%) を指定できます。デフォルト値: 100%。 |
20% |
| auto_vul_fix |
boolean |
任意 |
CVE 脆弱性を自動的に修正するかどうかを指定します。このパラメーターは |
true |
| auto_vul_fix_policy |
object |
任意 |
CVE の自動修正ポリシー。 |
|
| restart_node |
boolean |
任意 |
ノードの再起動を許可するかどうかを指定します。このパラメーターは
デフォルト値: |
true |
| vul_level |
string |
任意 |
自動修正が許可される脆弱性レベル (カンマ区切り)。例: |
asap,nntf |
| exclude_packages |
string |
任意 |
脆弱性修正中に除外するパッケージ。 |
kernel |
| auto_upgrade |
boolean |
任意 |
ノードを自動的にスペックアップするかどうかを指定します。このパラメーターは |
true |
| auto_upgrade_policy |
object |
任意 |
自動スペックアップポリシー。 |
|
| auto_upgrade_kubelet |
boolean |
任意 |
kubelet の自動スペックアップを許可するかどうかを指定します。このパラメーターは |
true |
| auto_upgrade_runtime |
boolean |
任意 |
ランタイムの自動スペックアップを許可するかどうかを指定します。このパラメーターは |
false |
| auto_upgrade_os |
boolean |
任意 |
オペレーティングシステムの自動スペックアップを許可するかどうかを指定します。このパラメーターは |
false |
upgrade_config
deprecated
|
object |
任意 |
[非推奨] 代わりに上位レベルの 自動アップグレード設定。このパラメーターは |
|
auto_upgrade
deprecated
|
boolean |
任意 |
[非推奨] 代わりに上位レベルの |
true |
| surge |
integer |
任意 |
追加ノードの数。このパラメーターまたは |
5 |
| surge_percentage |
integer |
任意 |
追加ノードの割合。このパラメーターまたは |
0 |
| max_unavailable |
integer |
任意 |
使用不可ノードの最大数。 |
1 |
| auto_fault_diagnosis |
boolean |
任意 |
ノードの自己修復における ECS 障害検出を有効にするかどうかを指定します。 |
|
| drift_enabled |
boolean |
任意 |
ノードローテーションを有効にするかどうかを指定します。インテリジェントマネージドノードプールのみがこの特徴をサポートしており、デフォルトで有効になっています。通常のノードプールはこの特徴をサポートしていません。 |
|
| scaling_group |
object |
任意 |
ノードプールのスケーリンググループ構成。 |
|
| vswitch_ids |
array |
任意 |
vSwitch の ID のリスト。有効な値: 1~8。 説明
高可用性を確保するため、異なるゾーンの vSwitch を選択してください。 |
|
|
string |
任意 |
vSwitch の ID。 |
vsw-wz9uwxhawmtzg7u9h**** |
|
| instance_types |
array |
任意 |
ノードのインスタンスタイプのリスト。代替として複数のインスタンスタイプを指定できます。ノード作成時、システムは最初のインスタンスタイプから順にインスタンスの購入を試み、作成が成功するまで続行します。最終的に購入されるインスタンスタイプは、在庫の可用性によって異なる場合があります。 |
|
|
string |
任意 |
インスタンスタイプ。詳細については、「インスタンスファミリー」を参照してください。フォーマット: |
ecs.c6.large |
|
| instance_charge_type |
string |
任意 |
ノードプール内のノードの課金方法。有効な値: |
PostPaid |
| period |
integer |
任意 |
ノードプール内のノードのサブスクリプション期間。このパラメーターは、
|
1 |
| period_unit |
string |
任意 |
ノードプール内のノードの課金サイクル。このパラメーターは |
Month |
| auto_renew |
boolean |
任意 |
ノードの自動更新を有効にするかどうかを指定します。このパラメーターは |
true |
| auto_renew_period |
integer |
任意 |
各自動更新サイクルの持続時間。有効な値: |
1 |
| spot_strategy |
string |
任意 |
スポットインスタンスのタイプ。有効な値: |
SpotWithPriceLimit |
| spot_price_limit |
array<object> |
任意 |
スポットインスタンスの値幅制限構成。 |
|
|
object |
任意 |
スポットインスタンスの値幅制限構成。 |
||
| instance_type |
string |
任意 |
スポットインスタンスのインスタンスタイプ。 |
ecs.c6.large |
| price_limit |
string |
任意 |
単一インスタンスの最大価格。 単位: USD/時間。 |
0.39 |
| image_type |
string |
任意 |
オペレーティングシステムのディストリビューションタイプ。ノードのオペレーティングシステムを指定するには、このフィールドを使用することを推奨します。有効な値:
|
AliyunLinux3 |
| image_id |
string |
任意 |
カスタムイメージの ID。 |
|
| system_disk_category |
string |
任意 |
ノードのシステムクラウドディスクのタイプ。有効な値:
デフォルト値: |
cloud_efficiency |
| system_disk_categories |
array |
任意 |
システムクラウドディスクの複数のクラウドディスクタイプ。優先度の高いクラウドディスクタイプが利用できない場合、システムは自動的に次の優先度のクラウドディスクタイプを試してシステムクラウドディスクを作成します。呼び出し順序に従って処理されます。 |
|
|
string |
任意 |
ノードの複数のシステムクラウドディスクタイプ。 |
cloud_essd |
|
| system_disk_size |
integer |
任意 |
ノードのシステムクラウドディスクのサイズ。単位: GiB。 |
120 |
| system_disk_performance_level |
string |
任意 |
ノードのシステムクラウドディスクのパフォーマンスレベル。このパラメーターは ESSD クラウドディスクに対してのみ有効です。パフォーマンスレベルはクラウドディスクのサイズに関連しています。詳細については、「ESSD クラウドディスク」を参照してください。フォーマット: |
PL1 |
| system_disk_encrypted |
boolean |
任意 |
システムクラウドディスクを暗号化するかどうかを指定します。有効な値: |
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_provisioned_iops |
integer |
任意 |
ノードのシステムディスクのプロビジョニング済み読み書き IOPS。 有効な範囲: 0 ~ min{50,000, 1000 × capacity - ベースラインパフォーマンス}。ベースラインパフォーマンス = min{1,800 + 50 × capacity, 50000}。 このパラメーターは、 |
1000 |
| system_disk_bursting_enabled |
boolean |
任意 |
ノードのシステムクラウドディスクのバースト機能 (I/O バースト機能) を有効にするかどうかを指定します。有効な値: |
true |
| data_disks |
array |
任意 |
ノードのデータクラウドディスク構成。有効な値: 0~10。最大 10 個のデータクラウドディスクを追加できます。 |
|
| data_disk |
任意 |
ノードのデータクラウドディスク構成。 |
||
| disk_init |
array |
任意 |
ブロックデバイスの初期化構成。 |
|
|
DiskInit |
任意 |
ブロックデバイスの初期化構成。 |
||
| key_pair |
string |
任意 |
キーペア名。このパラメーターまたは |
pro-nodepool |
| login_password |
string |
任意 |
SSH ログインパスワード。このパラメーターまたは |
Hello1234 |
| internet_charge_type |
string |
任意 |
パブリック IP アドレスの課金方法。有効な値: |
PayByBandwidth |
| internet_max_bandwidth_out |
integer |
任意 |
ノードのパブリック IP アドレスの最大アウトバウンド帯域幅。単位: Mbps (メガビット/秒)。有効な値: [1,100]。 |
5 |
| tags |
array |
任意 |
ECS インスタンスにのみタグを追加します。 |
|
| tag |
任意 |
ECS インスタンスのタグ。 |
||
| desired_size |
integer |
任意 |
ノードプールの希望ノード数。 |
2 |
| multi_az_policy |
string |
任意 |
スケーリンググループ内の ECS インスタンスのマルチゾーンスケーリングポリシー。有効な値: |
BALANCE |
| scaling_policy |
string |
任意 |
スケーリンググループモード。有効な値: |
release |
| on_demand_base_capacity |
integer |
任意 |
スケーリンググループに必要な従量課金インスタンスの最小値。有効な値: [0,1000]。従量課金インスタンスの数がこの値未満の場合、従量課金インスタンスが優先的に作成されます。 |
0 |
| on_demand_percentage_above_base_capacity |
integer |
任意 |
最小従量課金インスタンス要件 ( |
20 |
| spot_instance_pools |
integer |
任意 |
利用可能なインスタンスタイプの数。スケーリンググループは、複数のインスタンスタイプにわたってコスト最適化された方法でスポットインスタンスを作成します。有効な値: [1,10]。 |
5 |
| spot_instance_remedy |
boolean |
任意 |
スポットインスタンスの補充を有効にするかどうかを指定します。有効にすると、スケーリンググループがスポットインスタンスの回収に関するシステムメッセージを受信した際に、回収予定のスポットインスタンスを置き換えるために新しいインスタンスの作成を試みます。有効な値: |
false |
| compensate_with_on_demand |
boolean |
任意 |
指定されたスポットインスタンスがコストまたは在庫の理由で作成できない場合に、必要な ECS インスタンス数を満たすために従量課金インスタンスの自動作成を許可するかどうかを指定します。このパラメーターは、multi_az_policy が COST_OPTIMIZED に設定されている場合にのみ有効です。有効な値:
|
true |
| enable_high_density_mode |
boolean |
任意 |
高密度クラウドディスクモードを有効にするかどうかを指定します。これはノードプールがインスタンスタイプを使用している場合にのみサポートされます。有効にすると、システムクラウドディスクとデータクラウドディスクの合計数が、インスタンスタイプでサポートされる高密度クラウドディスク数を超えなくなります。 |
false |
| rds_instances |
array |
任意 |
RDS インスタンスのリスト。 |
|
|
string |
任意 |
RDS インスタンス ID。RDS インスタンスリストが指定されている場合、クラスターノード内の ECS インスタンスは自動的に RDS アクセスホワイトリストに追加され、呼び出しが許可されます。 |
rds-xxx |
|
| private_pool_options |
object |
任意 |
非公開ノードプールの構成。 |
|
| id |
string |
任意 |
非公開ノードプール ID。 |
eap-bp67acfmxazb4**** |
| match_criteria |
string |
任意 |
プライベートノードプールのタイプ。インスタンス起動時のプライベートプールオプションです。エラスティシティ保証またはキャパシティ予約が有効になると、インスタンスが起動時に使用するプライベートプールが生成されます。有効な値:
|
Open |
platform
deprecated
|
string |
任意 |
[非推奨] 代わりに オペレーティングシステムのプラットフォーム。有効な値:
|
AliyunLinux |
| instance_patterns |
array |
任意 |
インスタンス属性の構成。 |
|
| instance_patterns |
任意 |
インスタンスの属性。 |
||
| deploymentset_id |
string |
任意 |
ノードプールによって作成された ECS インスタンスが属するデプロイメントセット。この設定は新規ノードに対してのみ有効です。既存ノードのデプロイメントセットは変更されません。 |
ds-bp1d19mmbsv3jf6xxxxx |
| security_group_ids |
array |
任意 |
セキュリティグループ ID のリスト。 |
|
|
string |
任意 |
セキュリティグループ ID。 |
sg-wz9a8g2mt6x5ll****** |
|
| resource_pool_options |
object |
任意 |
インスタンス作成時に使用されるリソースプールおよびリソースプール戦略。このパラメーターを設定後は、以下の点にご注意ください: |
|
| strategy |
string |
任意 |
インスタンス作成時に使用されるリソースプール戦略。リソースプールには、エラスティシティ保証またはキャパシティー予約の有効化後に生成される非公開プールと、インスタンスの起動に使用できるパブリックプールが含まれます。有効な値:
デフォルト値: None。 |
PrivatePoolFirst |
| private_pool_ids |
array |
任意 |
非公開プール ID のリスト (エラスティシティ保証 ID またはキャパシティー予約 ID)。Target モードの非公開プール ID のみ指定できます。N の有効値: 1~20。 |
|
|
string |
任意 |
非公開プール ID (エラスティシティ保証 ID またはキャパシティー予約 ID)。Target モードの非公開プール ID のみ指定できます。 |
eap-bp67acfmxazb4**** |
|
| system_disk_snapshot_policy_id |
string |
任意 |
システムクラウドディスクのスナップショットポリシー。 |
sp-0jl6xnmme8v7o935**** |
| kubernetes_config |
object |
任意 |
クラスター関連の構成。 |
|
| labels |
array |
任意 |
ノードラベル。Kubernetes クラスターのノードにラベルを追加できます。ラベル定義ルール: |
|
| tag |
任意 |
ノードラベル。 |
||
| taints |
array |
任意 |
ノードの Taint 構成。 |
|
| taint |
任意 |
ノードの Taint 構成。 |
||
| runtime |
string |
任意 |
コンテナランタイム名。ACK は以下の 3 つのコンテナランタイムをサポートしています。
デフォルト値: containerd。 |
containerd |
| runtime_version |
string |
任意 |
コンテナランタイムバージョン。 |
1.6.38 |
| cpu_policy |
string |
任意 |
ノードの CPU 管理ポリシー。バージョン 1.12.6 以降のクラスターでは、以下の 2 つのポリシーがサポートされています。 |
none |
| unschedulable |
boolean |
任意 |
スケールアウト時に追加されるノードをスケジュール不可にするかどうかを指定します。 |
false |
| user_data |
string |
任意 |
インスタンスのユーザーデータ。ノードがクラスターに参加した後、指定されたユーザースクリプトが実行されます。詳細については、「User data scripts」を参照してください。 |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| cms_enabled |
boolean |
任意 |
ECS ノードに CloudMonitor エージェントをインストールするかどうかを指定します。インストール後、CloudMonitor コンソールで作成された ECS インスタンスのモニタリング情報を確認できます。この機能を有効にすることを推奨します。有効な値:
デフォルト値: |
true |
| pre_user_data |
string |
任意 |
インスタンスの事前ユーザーデータ。ノードがクラスターに参加する前に、指定された事前ユーザースクリプトが実行されます。詳細については、「User data scripts」を参照してください。 |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| node_name_mode |
string |
任意 |
カスタムノード名パラメーター。ノード名は、プレフィックス + ノード IP アドレス + サフィックスの 3 つの部分で構成されます。 |
customized,aliyun,ip,com |
| tee_config |
object |
任意 |
機密コンピューティングクラスターの構成。 |
|
| tee_enable |
boolean |
任意 |
中国準拠の機密コンピューティングクラスターを有効にするかどうかを指定します。有効な値:
デフォルト値: |
false |
| update_nodes |
boolean |
任意 |
ノードラベルと Taint を同期更新するかどうかを指定します。 |
true |
| concurrency |
boolean |
任意 |
同時実行数を有効にするかどうかを指定します。 |
true |
| eflo_node_group |
object |
任意 |
Lingjun ノードプールの構成。(効果なし) |
|
| auto_attach_enabled |
string |
任意 |
Lingjun ノードプールの自動追加を有効にするかどうかを指定します。(効果なし) |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスボディのデータ。 |
||
| task_id |
string |
タスクの ID。 |
T-5fd211e924e1d00787000293 |
| nodepool_id |
string |
ノードプールの ID。 |
np737c3ac1ac684703b9e10673aa2c**** |
| request_id |
string |
リクエストの ID。 |
687C5BAA-D103-4993-884B-C35E4314**** |
例
成功レスポンス
JSONJSON
{
"task_id": "T-5fd211e924e1d00787000293",
"nodepool_id": "np737c3ac1ac684703b9e10673aa2c****",
"request_id": "687C5BAA-D103-4993-884B-C35E4314****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。