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

Container Service for Kubernetes:ModifyCluster

最終更新日:May 21, 2026

ModifyCluster を呼び出して、ACK クラスターの設定を変更します。

操作説明

重要 2026年7月4日をもって、リクエストパラメーター instance_deletion_protectioningress_loadbalancer_id、および access_control_list は無視されます。詳細については、「ACK クラスター管理における OpenAPI リクエスト・レスポンスパラメーターの変更および非推奨のお知らせ」をご参照ください。

今すぐお試しください

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

update

*Cluster

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

  • cs:EnableApiServerEip
  • cs:ApiServerEipId
なし

リクエスト構文

PUT /api/v2/clusters/{ClusterId} HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

ClusterId

string

必須

クラスター ID。

cb95aa626a47740afbf6aa099b65****

リクエストパラメーター

パラメーター

必須 / 任意

説明

body

object

任意

リクエストボディのパラメーターです。

true

api_server_eip

boolean

任意

クラスターの API サーバーに EIP を関連付けてパブリックアクセスを許可するかどうかを指定します。有効な値:

  • true:クラスターに EIP を関連付けます。

  • false:クラスターに EIP を関連付けません。

true

api_server_eip_id

string

任意

クラスターの API サーバーに関連付けられている EIP インスタンスの ID。このパラメーターは、api_server_eiptrue に設定されている場合にのみ適用されます。

eip-wz9fnasl6dsfhmvci****

deletion_protection

boolean

任意

クラスターの削除保護を有効にするかどうかを指定します。有効な値:

  • true:削除保護を有効にします。コンソールから、または API を呼び出してクラスターを削除することはできません。

  • false:削除保護を無効にします。コンソールから、または API を呼び出してクラスターを削除できます。

デフォルト値: false

false

resource_group_id

string

任意

クラスターが属するリソースグループの ID。

rg-acfmyvw3wjm****

maintenance_window maintenance_window

任意

クラスターのメンテナンスウィンドウ。この設定は、ACK Pro マネージドクラスターにのみ適用されます。

enable_rrsa

boolean

任意

サービスアカウントの RAM ロール (RRSA) 機能を有効にするかどうかを指定します。この設定は、マネージドクラスターにのみ適用されます。有効な値:

  • true:RRSA 機能を有効にします。

  • false:RRSA 機能を無効にします。

true

cluster_name

string

任意

クラスターの名前。名前は 1~63 文字で、数字、文字、漢字、ハイフン (-) を使用できますが、ハイフンで始めることはできません。

cluster-new-name

cluster_spec

string

任意

クラスターの仕様。このパラメーターは、cluster_typeManagedKubernetes に設定され、profile パラメーターが設定されている場合にのみ適用されます。有効な値:

  • ack.pro.small:Pro Edition

  • ack.pro.xlarge:Pro XL

  • ack.pro.2xlarge:Pro 2XL

  • ack.pro.4xlarge:Pro 4XL (カスタマーサポートに連絡して許可リストへの追加を依頼する必要があります)。

Pro XL、Pro 2XL、Pro 4XL は、ACK Pro プロビジョニング済みコントロールプレーンによって提供される 3 つの仕様です。この機能は、コントロールプレーンリソースを事前に割り当てて固定することで、一貫して高いレベルの API 同時実行性と Pod のスケジューリング機能を確保します。これは、AI トレーニングと推論、大規模クラスター、およびミッションクリティカルなサービスに適しています。

Pro 版およびプロビジョニング済みコントロールプレーンクラスターのクラスター管理料金については、「クラスター管理料金」をご参照ください。

ack.pro.small

system_events_logging

object

任意

システムイベントを保存するための設定。

enabled

boolean

任意

システムイベントロギングを有効にするかどうかを指定します。有効な値:

  • true:システムイベントロギングを有効にします。

  • false:システムイベントロギングを無効にします。

true

logging_project

string

任意

システムイベントを保存するための Log Service プロジェクトの名前。

k8s-log-cb95aa626a47740afbf6aa099b65****

operation_policy

object

任意

クラスターの自動 O&M ポリシー。

cluster_auto_upgrade

object

任意

クラスターの自動アップグレードポリシー。

enabled

boolean

任意

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

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

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

true

channel

string

任意

自動アップグレードチャネル。詳細については、「アップグレードチャネル」をご参照ください。

有効な値:

  • patch:最新のパッチバージョンにアップグレードします。

  • stable:最新の安定したマイナーバージョンにアップグレードします。

  • rapid:最新のマイナーバージョン。

patch

api_server_custom_cert_sans

object

任意

API サーバー証明書のカスタムサブジェクトの別名 (SAN)。このパラメーターを使用すると、クライアントアクセス制御のために、カスタム IP アドレスまたはドメイン名を API サーバー証明書の SAN フィールドに追加できます。

このパラメーターは、マネージドクラスターでのみ使用できます。

action

string

任意

SAN の変更方法。有効な値:

  • overwrite:既存の SAN を上書きします。

  • append:既存の SAN に追加します。

append

subject_alternative_names

array

任意

SAN のリスト。

string

任意

単一の SAN。IP アドレスまたはドメイン名を指定できます。

aliyun.xxx.com,192.168.xx.xx

vswitch_ids

array

任意

クラスターのコントロールプレーン用の VSwitch。専用クラスターでは、変更は新しく追加されたコントロールプレーンノードにのみ適用されます。マネージドクラスターでコントロールプレーンの VSwitch を変更する場合は、次の点に注意してください:

  • このパラメーターは上書き更新を実行します。ターゲットの VSwitch の完全なリストを指定する必要があります。

  • 変更中にコントロールプレーンコンポーネントが短時間再起動します。慎重に実行してください。

  • すべてのセキュリティグループ (コントロールプレーンのセキュリティグループ、すべてのノードプールのセキュリティグループ、コンテナネットワークのセキュリティグループを含む) のインバウンドルールとアウトバウンドルールが、新しい VSwitch の IP アドレス CIDR ブロックからのトラフィックを許可していることを確認してください。そうしないと、ノードとコンテナが API サーバーに接続できなくなる可能性があります。

  • 新しいコントロールプレーンの VSwitch が ACL に関連付けられている場合は、ACL ルールでクラスターノードとコンテナネットワークの IP アドレス CIDR ブロックとの通信が許可されていることを確認してください。

string

任意

クラスターのコントロールプレーン用の VSwitch。

vsw-2ze4jvvvade1yk899****

control_plane_config

object

任意

専用クラスターのコントロールプレーンの設定。

charge_type

string

任意

コントロールプレーンノードの課金方法。有効な値:

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

  • PostPaid:従量課金。

デフォルト値: PostPaid

PostPaid

period

integer

任意

コントロールプレーンノードのサブスクリプション期間。このパラメーターは、charge_typePrePaid に設定されている場合にのみ必須です。

period_unitMonth に設定されている場合、有効な値は 1、2、3、6、12、24、36、48、60 です。

1

period_unit

string

任意

コントロールプレーンノードの請求サイクル。このパラメーターは、charge_typePrePaid に設定されている場合にのみ適用されます。

Month:月単位の請求サイクルです。月単位のサブスクリプションのみがサポートされています。

Month

auto_renew

boolean

任意

サブスクリプションのコントロールプレーンノードの自動更新を有効にするかどうかを指定します。このパラメーターは、charge_typePrePaid に設定されている場合にのみ有効です。有効な値:

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

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

デフォルト値: false

false

auto_renew_period

integer

任意

コントロールプレーンノードの自動更新期間 (月単位)。

有効な値:1、2、3、6、12。

デフォルト値: 1

1

instance_types

array

任意

インスタンスタイプ。詳細については、「インスタンスタイプ」をご参照ください。

string

任意

インスタンスタイプ。

ecs.g6.large

image_type

string

任意

OS イメージのタイプ。有効な値:

  • AliyunLinux3:Aliyun Linux 3 イメージ。

  • Custom:カスタムイメージ。

AliyunLinux3

image_id

string

任意

カスタムイメージの ID。カスタムイメージを使用する場合は、このパラメーターを指定します。

aliyun_3_x64_20G_alibase_20240819.vhd

key_pair

string

任意

キーペアの名前。このパラメーターまたは login_password のいずれかを指定する必要があります。

ack

login_password

string

任意

SSH ログオンパスワード。このパラメーターまたは key_pair のいずれかを指定する必要があります。パスワードは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含んでいる必要があります。パスワードを使用する場合、スケールアウト操作中に新しいコントロールプレーンノードに適用されます。

Ack@2000.

system_disk_category

string

任意

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

  • cloud_efficiency:Ultra Disk。

  • cloud_ssd:SSD。

  • cloud_essd:ESSD。

  • cloud_auto:ESSD AutoPL ディスク。

  • cloud_essd_entry:ESSD Entry ディスク。

cloud_essd

system_disk_size

integer

任意

ノードのシステムディスクのサイズ (GiB)。値は 40~500 の範囲である必要があります。

120

system_disk_snapshot_policy_id

string

任意

ノードのシステムディスクに適用する自動スナップショットポリシーの ID。

sp-2zej1nogjvovnz4z****

system_disk_performance_level

string

任意

システムディスクのパフォーマンスレベル (PL)。このパラメーターは ESSD にのみ適用されます。PL はディスクサイズによって異なります。詳細については、「ESSD」をご参照ください。

PL1

system_disk_provisioned_iops

integer

任意

ノードシステムディスクのプロビジョンド IOPS。有効な値:0~min{50,000, 1,000 × Capacity - Base IOPS}。Base IOPS = min{1,800 + 50 × Capacity, 50,000}。

このパラメーターは、system_disk_categorycloud_auto に設定されている場合にのみ設定できます。詳細については、「ESSD AutoPL ディスク」をご参照ください。

1000

system_disk_bursting_enabled

boolean

任意

システムディスクのパフォーマンスバースト機能を有効にするかどうかを指定します。有効な値:

  • true:パフォーマンスバースト機能を有効にします。

  • false:パフォーマンスバースト機能を無効にします。

このパラメーターは、system_disk_categorycloud_auto に設定されている場合にのみ設定できます。詳細については、「ESSD AutoPL ディスク」をご参照ください。

true

deploymentset_id

string

任意

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

ds-bp10b35imuam5amw****

cloud_monitor_flags

boolean

任意

コントロールプレーンノードに CloudMonitor エージェントをインストールするかどうかを指定します。有効な値:

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

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

true

soc_enabled

boolean

任意

MLPS 準拠のセキュリティ強化を有効にするかどうかを指定します。詳細については、「ACK の MLPS 準拠のセキュリティ強化を有効にする」をご参照ください。

有効な値:

  • true:MLPS 準拠のセキュリティ強化を有効にします。

  • false:MLPS 準拠のセキュリティ強化を無効にします。

デフォルト値: false

false

security_hardening_os

boolean

任意

Alibaba Cloud OS Security Hardening を有効にするかどうかを指定します。有効な値:

  • true:Alibaba Cloud OS Security Hardening を有効にします。

  • false:Alibaba Cloud OS Security Hardening を無効にします。

デフォルト値: false

false

cpu_policy

string

任意

ノードの CPU 管理ポリシー。Kubernetes 1.12.6 以降のクラスターでは、次のポリシーがサポートされています:

  • static:特定のリソース特性を持つ Pod が、ノード上で強化された CPU アフィニティと排他性を持つことを可能にします。

  • none:デフォルトの CPU アフィニティスキームを使用します。

デフォルト値: none

none

runtime

string

任意

コンテナランタイム。有効な値:

  • containerd:推奨します。このランタイムはすべてのクラスターバージョンでサポートされています。

デフォルト値: containerd

containerd

node_port_range

string

任意

クラスターの NodePort 範囲。範囲は 30000~65535 である必要があります。

デフォルト値: 30000-32767

30000-32767

size

integer

任意

コントロールプレーンノードの数。専用クラスターのコントロールプレーンをスケールアウトするには、このパラメーターをターゲットのコントロールプレーンノード数に設定します。この数は現在の数より大きい必要があります。

5

security_group_id

string

任意

コントロールプレーンのセキュリティグループの ID。

  • セキュリティグループで拒否ルールを設定する場合は、セキュリティグループのルールが、クラスターに必要なプロトコルとポートのトラフィックを許可していることを確認してください。推奨されるセキュリティグループのルールについては、「クラスターのセキュリティグループの設定と管理」をご参照ください。

  • マネージドクラスターの場合、変更中にコントロールプレーンとインストールされているマネージドコンポーネント (terway-controlplane など) が短時間再起動します。この操作はオフピーク時に実行することを推奨します。コントロールプレーンのセキュリティグループを変更すると、コントロールプレーンとマネージドコンポーネントが使用する Elastic Network Interface (ENI) が自動的に新しいセキュリティグループに追加されます。

  • 専用クラスターの場合、コントロールプレーンのセキュリティグループを変更すると、新しいセキュリティグループは新しく追加されたコントロールプレーンノードに自動的に適用されます。既存のコントロールプレーンノードは影響を受けません。

sg-bp1h6rk3pgct2a08***

timezone

string

任意

クラスターのタイムゾーン。詳細については、「サポートされているタイムゾーン」をご参照ください。

  • タイムゾーンを変更すると、クラスター検査の設定は新しいタイムゾーン設定を使用します。

  • マネージドクラスターの場合、変更中にコントロールプレーンとインストールされているマネージドコンポーネント (terway-controlplane など) が短時間再起動します。この操作はオフピーク時に実行することを推奨します。タイムゾーンを変更すると、新しいタイムゾーンは新しく追加されたノードに自動的に適用されます。既存のノードは影響を受けません。ノードプール内のノードをリセットして、新しいタイムゾーンを既存のノードに適用できます。

  • 専用クラスターの場合、タイムゾーンを変更すると、新しいタイムゾーンは新しく追加されたノード (コントロールプレーンノードを含む) に自動的に適用されます。既存のノード (コントロールプレーンノードを含む) は影響を受けません。ノードプール内のノードをリセットして、新しいタイムゾーンを既存のワーカーノードに適用できます。すべてのコントロールプレーンノードに新しいタイムゾーンを適用するには、コントロールプレーンをスケールアウトしてからスケールインする必要があります。

Asia/Shanghai

control_plane_endpoints_config

object

任意

クラスター接続の設定。

internal_dns_config

object

任意

クラスターの内部 DNS 設定。このパラメーターは ACK マネージドクラスターにのみ適用されます。kubelet や kube-proxy などのノード側のシステムコンポーネントは、クラスターの内部ドメインを使用して API サーバーにアクセスします。この機能が無効になっている場合、SLB の IP アドレスを使用して API サーバーにアクセスします。

bind_vpcs

array

任意

クラスターの内部ドメインレコードが有効になる VPC。

string

任意

クラスターの内部ドメインレコードが有効になる VPC。

vpc-xxxx

enabled

boolean

任意

内部ドメイン経由でクラスターへのアクセスを有効にするかどうかを指定します。有効な値:

  • true:内部ドメイン経由でクラスターへのアクセスを有効にします。kubelet や kube-proxy などのノード側コンポーネントは、クラスターの内部ドメインを使用して API サーバーにアクセスします。

true

access_control_list deprecated

array

任意

登録済みクラスターの API サーバー用 SLB インスタンスのアクセス制御リストです。

string

任意

アクセス制御リストの CIDR ブロックです。

:0.0.0.0/0 CIDR ブロックは指定しないでください。

192.168.XX.XX/24

instance_deletion_protection deprecated

boolean

任意

ノードの削除保護を有効にするかどうかを指定します。有効にすると、コンソールから、または API を呼び出してノードを解放することはできません。有効な値:

  • true:コンソールから、または API を呼び出してノードを解放することはできません。

  • false:コンソールから、または API を呼び出してノードを解放できます。

デフォルト値: false

false

ingress_domain_rebinding deprecated

boolean

任意

クラスターのデフォルトの Ingress ドメイン名を再バインドするかどうかを指定します。有効な値:

  • true:クラスターのデフォルトの Ingress ドメイン名を再バインドします。

  • false:クラスターのデフォルトの Ingress ドメイン名を再バインドしません。

デフォルト値: false

false

ingress_loadbalancer_id deprecated

string

任意

クラスターの Ingress に使用される SLB インスタンスの ID です。

lb-wz97kes8tnndkpodw****

レスポンスフィールド

フィールド

説明

object

変更リクエストで返されるデータ。

cluster_id

string

クラスターの一意の識別子。

cb95aa626a47740afbf6aa09****

request_id

string

リクエストの一意の識別子。トラブルシューティングの際は、この ID をサポートチケットに記載してください。

687C5BAA-D103-4993-884B-C35E4314****

task_id

string

非同期変更タスクの一意の識別子。

T-5a54309c80282e39ea00****

成功レスポンス

JSONJSON

{
  "cluster_id": "cb95aa626a47740afbf6aa09****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea00****"
}

エラーコード

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

変更履歴

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