すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:ModifyCluster

    ドキュメントセンター

    Container Service for Kubernetes:ModifyCluster

    最終更新日:Jul 16, 2026

    ACK クラスターの構成を変更します。

    操作説明

    重要 2026 年 7 月 4 日以降、リクエストパラメーター instance_deletion_protection、ingress_loadbalancer_id、access_control_list は有効ではなくなります。変更の詳細については、「ACK クラスター管理 OpenAPI のリクエストおよび応答パラメーターの変更と 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_eip が true に設定されている場合にのみ有効です。

    eip-wz9fnasl6dsfhmvci****
    deletion_protection

    boolean

    任意

    コンソールまたは API による誤削除を防ぐために、クラスターの削除保護を有効にするかどうかを指定します。有効な値:

    • true: クラスターの削除保護を有効にします。コンソールまたは API を通じてクラスターを削除することはできません。

    • false: クラスターの削除保護を無効にします。コンソールまたは API を通じてクラスターを削除できます。

    デフォルト値: false。

    false
    resource_group_id

    string

    任意

    クラスターのリソースグループの ID。

    rg-acfmyvw3wjm****
    maintenance_window maintenance_window

    任意

    クラスターの O&M ウィンドウ構成。この機能はコンテナサービス ACK Pro クラスターでのみ有効です。

    enable_rrsa

    boolean

    任意

    RRSA 機能を有効または無効にするかどうかを指定します。このパラメーターはマネージドクラスターでのみサポートされます。有効な値:

    • true: 有効。

    • false: 無効。

    true
    cluster_name

    string

    任意

    カスタムクラスター名。名前には数字、漢字、英字、ハイフン (-) を含めることができます。長さは 1～63 文字で、ハイフン (-) で始めることはできません。

    cluster-new-name
    cluster_spec

    string

    任意

    cluster_type が ManagedKubernetes に設定され、profile が構成されている場合のクラスター仕様。有効な値:

    • ack.pro.small: コンテナサービス ACK プロ版

    • ack.pro.xlarge: コンテナサービス ACK プロ版 XL

    • ack.pro.2xlarge: コンテナサービス ACK プロ版 2XL

    • ack.pro.4xlarge: コンテナサービス ACK プロ版 4XL (アカウントをホワイトリストに追加するには連絡先であるカスタマーサービスにお問い合わせください)

    コンテナサービス ACK プロ版 XL、コンテナサービス ACK プロ版 2XL、コンテナサービス ACK プロ版 4XL は、ACK Pro Provisioned Control Plane が提供する 3 つのティアです。これらのティアは、コントロールプレーンのリソースを事前に割り当てて専有することで、API の同時実行数と Pod のスケジューリング機能を常に高いレベルに維持します。AI トレーニングや推論、超大規模クラスター、重大なワークロードに適しています。

    コンテナサービス ACK プロ版および Provisioned Control Plane エディションのクラスター管理料金の詳細については、「クラスター管理料金」をご参照ください。

    ack.pro.small
    system_events_logging

    object

    任意

    システムイベントのストレージ構成。

    enabled

    boolean

    任意

    システムイベントストレージを有効にするかどうかを指定します。

    • true: システムイベントストレージを有効にします。

    • false: システムイベントストレージを無効にします。

    true
    logging_project

    string

    任意

    システムイベントストレージ用のログプロジェクトの名前。

    k8s-log-cb95aa626a47740afbf6aa099b65****
    operation_policy

    object

    任意

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

    cluster_auto_upgrade

    object

    任意

    クラスターの自動スペックアップ構成。

    enabled

    boolean

    任意

    クラスターの自動スペックアップを有効にするかどうかを指定します。

    • true: 自動スペックアップを有効にします。

    • false: 自動スペックアップを無効にします。

    true
    channel

    string

    任意

    クラスターの自動スペックアップチャンネル。詳細については、「スペックアップチャンネル」を参照してください。

    有効な値:

    • patch: 最新のパッチバージョン。

    • stable: 2 番目に新しいマイナーバージョン。

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

    patch
    api_server_custom_cert_sans

    object

    任意

    カスタム API サーバー証明書の SAN (Subject Alternative Name)。このパラメーターは、クライアントのアクセス制御のために、クラスター API サーバー証明書の SAN フィールドにカスタム IP アドレスまたはドメイン名を追加します。

    このパラメーターはマネージドクラスターでのみサポートされます。

    action

    string

    任意

    SAN 構成を上書きするか追加するかを指定します。有効な値:

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

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

    append
    subject_alternative_names

    array

    任意

    SAN のリスト。

    string

    任意

    SAN。カスタム IP アドレスまたはドメイン名がサポートされます。複数の IP アドレスまたはドメイン名はカンマ (,) で区切ります。

    aliyun.xxx.com,192.168.xx.xx
    vswitch_ids

    array

    任意

    クラスターコントロールプレーン用の vSwitch。専用クラスターの場合、変更は新しくスケールアウトされたコントロールプレーンノードに適用されます。マネージドクラスターのコントロールプレーン vSwitch を変更する際は、以下の点にご注意ください:

    • このパラメーターは完全な上書きを実行します。ターゲット vSwitch の完全なリストを指定してください。

    • 変更中、コントロールプレーンのコンポーネントが一時的に再起動します。慎重に操作してください。

    • クラスターのすべてのセキュリティグループ (コントロールプレーンのセキュリティグループ、すべてのノードプールのセキュリティグループ、コンテナネットワークで使用されるセキュリティグループを含む) が、新しい vSwitch の IP CIDR ブロックのインバウンドおよびアウトバウンドトラフィックを許可していることを確認してください。これにより、ノードやコンテナが API サーバーに接続できなくなるのを防ぎます。

    • 新しいコントロールプレーン vSwitch に ACL ルールが設定されている場合は、ACL ルールがクラスターノードおよびコンテナネットワークの CIDR ブロックとの通信を許可していることを確認してください。

    string

    任意

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

    vsw-2ze4jvvvade1yk899****
    control_plane_config

    object

    任意

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

    charge_type

    string

    任意

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

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

    • PostPaid: 従量課金。

    デフォルト値: PostPaid。

    PostPaid
    period

    integer

    任意

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

    period_unit=Month の場合、有効な値は {1, 2, 3, 6, 12, 24, 36, 48, 60} です。

    1
    period_unit

    string

    任意

    コントロールプレーンノードインスタンスの課金サイクル単位。このパラメーターは、charge_type が PrePaid に設定されている場合にのみ有効です。

    Month: 月額課金。現在、月額課金のみがサポートされています。

    Month
    auto_renew

    boolean

    任意

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

    • 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

    任意

    オペレーティングシステムのイメージタイプ。有効な値:

    • AliyunLinux3: Alinux3 イメージ。

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

    • cloud_ssd: 標準 SSD。

    • cloud_essd: ESSD。

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

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

    cloud_essd
    system_disk_size

    integer

    任意

    ノードシステムクラウドディスクのサイズ。有効な値: [40, 500]。単位: GiB。

    120
    system_disk_snapshot_policy_id

    string

    任意

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

    sp-2zej1nogjvovnz4z****
    system_disk_performance_level

    string

    任意

    ノードシステムクラウドディスクのパフォーマンスレベル (PL)。このパラメーターは ESSD クラウドディスクでのみ有効です。パフォーマンスレベルはディスクサイズに関連しています。詳細については、「標準 SSD」をご参照ください。

    PL1
    system_disk_provisioned_iops

    integer

    任意

    ノードシステムクラウドディスクのプロビジョニング済み読み取り/書き込み IOPS。有効な値: 0 ～ min{50,000, 1000 × capacity - ベースライン performance}。Baseline performance = min{1,800 + 50 × capacity, 50,000}。

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

    1000
    system_disk_bursting_enabled

    boolean

    任意

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

    • true: 有効。

    • false: 無効。

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

    true
    deploymentset_id

    string

    任意

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

    ds-bp10b35imuam5amw****
    cloud_monitor_flags

    boolean

    任意

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

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

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

    true
    soc_enabled

    boolean

    任意

    等級保護 2.0 セキュリティ強化を有効にするかどうかを指定します。詳細については、「ACK の中国等級保護コンプライアンス」をご参照ください。

    有効な値:

    • true: 等級保護 2.0 セキュリティ強化を有効にします。

    • false: 等級保護 2.0 セキュリティ強化を無効にします。

    デフォルト値: false。

    false
    security_hardening_os

    boolean

    任意

    Alibaba Cloud OS セキュリティ強化を有効にするかどうかを指定します。有効な値:

    • true: Alibaba Cloud OS セキュリティ強化を有効にします。

    • false: Alibaba Cloud OS セキュリティ強化を無効にします。

    デフォルト値: false。

    false
    cpu_policy

    string

    任意

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

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

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

    デフォルト値: none。

    none
    runtime

    string

    任意

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

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

    デフォルト値: containerd。

    containerd
    node_port_range

    string

    任意

    ノードのサービスポート有効値。利用可能なポート範囲: [30000, 65535]。

    デフォルト値: 30000-32767。

    30000-32767
    size

    integer

    任意

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

    5
    security_group_id

    string

    任意

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

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

    • ACK 専用クラスター以外のクラスターの場合、変更中にコントロールプレーンのコンポーネントおよびインストール済みのマネージドコンポーネント (terway-controlplane など) が一時的に再起動します。この操作はオフピーク時に実行してください。コントロールプレーンのセキュリティグループが変更された後、コントロールプレーンおよびインストール済みのマネージドコンポーネントが使用するネットワークインターフェースは、クラスター管理プロシージャ中に自動的に新しいセキュリティグループに追加されます。

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

    sg-bp1h6rk3pgct2a08***
    timezone

    string

    任意

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

    • タイムゾーンが変更された後、クラスター検査構成は新しいタイムゾーン設定を使用します。

    • マネージドクラスターの場合、変更中にコントロールプレーンのコンポーネントおよびインストール済みのマネージドコンポーネント (terway-controlplane など) が一時的に再起動します。この操作はオフピーク時に実行してください。タイムゾーンが変更された後、新しくスケールアウトされたノードは自動的に新しいタイムゾーン設定を使用します。既存のノードは影響を受けません。ノードプールのノードリセット機能を使用して、既存のノードに新しい設定を適用できます。

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

    Asia/Shanghai
    client_token

    string

    任意

    クライアントトークン。

    af31042c-6355-495b-b6e3-exxb9669
    control_plane_endpoints_config

    object

    任意

    クラスターエンドポイントの構成。

    load_balancers_config

    array<object>

    任意

    クラスターアクセスの負荷分散構成。

    object

    任意

    クラスターアクセスの負荷分散構成。

    endpoint_type

    string

    任意

    エンドポイントタイプ。

    public
    load_balancer_id

    string

    任意

    エンドポイントに関連付けられた SLB インスタンス。

    nlb-xxxx
    internal_dns_config

    object

    任意

    クラスターの内部 DNS 構成。ACK マネージドクラスターに適用されます。内部ドメイン名は、kubelet や kube-proxy などのノード側のシステムコンポーネントが API サーバーにアクセスするために使用されます。内部ドメイン名アクセスが有効になっていない場合、ノード側のシステムコンポーネントは CLB 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

    任意

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

    注意: 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

    任意

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

    • true: クラスターテストドメイン名を再バインドします。

    • false: クラスターテストドメイン名を再バインドしません。

    デフォルト値: false。

    false
    ingress_loadbalancer_id deprecated

    string

    任意

    変更済みのクラスターの SLB インスタンス ID。

    lb-wz97kes8tnndkpodw****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスボディ。

    cluster_id

    string

    クラスターの ID。

    cb95aa626a47740afbf6aa09****
    request_id

    string

    リクエストの ID。

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

    string

    タスクの ID。

    T-5a54309c80282e39ea00****

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

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

    変更履歴

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