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

Container Service for Kubernetes:ACK API パラメーターの変更と非推奨化に関するお知らせ

最終更新日:Dec 26, 2025

Container Service for Kubernetes (ACK) は、2026 年 7 月 4 日に、パラメーターの非推奨化やインターフェイスの完全な廃止を含む、いくつかの API の調整を予定しています。非推奨化されたパラメーターは機能しなくなり、廃止された API は呼び出しできなくなります。このトピックでは、推奨されるソリューションについて説明します。

変更内容と影響範囲

  • 実施時期:2026 年 7 月 4 日からリージョンごとに順次展開を開始し、2026 年 9 月 30 日までにグローバルでの展開を完了する予定です。

  • 影響範囲:この更新には、特定の API のパラメーター変更と、その他の API の完全な廃止が含まれます。直接呼び出し、Terraform 構成、Resource Orchestration Service (ROS) テンプレート、またはその他の API ベースのリクエストを問わず、以下の表にある API を使用している場合は、この変更の影響を受けます。

    変更タイプ

    非推奨化の詳細

    影響を受ける API

    API パラメーターの非推奨化

    操作系 API:一部のリクエストパラメーターが無効になるか、リクエストの検証でエラーコード 400 が返されます。

    • CreateCluster

    • CreateClusterByResourcesGroup

    • ModifyCluster

    • UpgradeCluster

    クエリ系 API:レスポンス本文に非推奨フィールドが含まれなくなります。

    • DescribeClusterDetail

    API の廃止

    API は恒久的に無効化され、アクセスできなくなります。

    • DescribeClusters

    • DescribeClustersV1

    • GetUpgradeStatus

    • PauseClusterUpgrade

    • CancelClusterUpgrade

    • ResumeUpgradeCluster

非推奨パラメーターとソリューション

以下の表の「代替パラメーター」列に記載されているパラメーターは、非推奨となるパラメーターと同じ API インターフェイス内で利用可能です。

CreateCluster

説明
  • ACK 専用クラスターのマスターノード設定パラメーターは、control_plane_config フィールドに集約されます。

    ACK 専用クラスターの作成は廃止されました。詳細については、「ACK 専用クラスターの作成 (廃止)」をご参照ください。
  • クラスター内のワーカーノード設定パラメーターは、nodepools フィールドに集約されます。クラスター作成後は、CreateClusterNodePool の同じフィールドを使用してノードプールを作成および設定することを推奨します。

非推奨パラメーター

代替パラメーター

master_vswitch_ids

vswitch_ids

master_instance_charge_type

control_plane_config.charge_type

master_period

control_plane_config.period

master_period_unit

control_plane_config.period_unit

master_auto_renew

control_plane_config.auto_renew

master_auto_renew_period

control_plane_config.auto_renew_period

master_instance_types

control_plane_config.instance_types

master_system_disk_category

control_plane_config.system_disk_category

master_system_disk_size

control_plane_config.system_disk_size

master_system_disk_performance_level

control_plane_config.system_disk_performance_level

master_system_disk_snapshot_policy_id

control_plane_config.system_disk_snapshot_policy_id

master_deploymentset_id

control_plane_config.deploymentset_id

master_count

control_plane_config.size

node_port_range

control_plane_config.node_port_range

num_of_nodes

nodepools[].scaling_group.desired_size

worker_vswitch_ids

nodepools[].scaling_group.vswitch_ids

worker_instance_types

nodepools[].scaling_group.instance_types

worker_system_disk_category

nodepools[].scaling_group.system_disk_category

worker_system_disk_size

nodepools[].scaling_group.system_disk_size

worker_system_disk_snapshot_policy_id

nodepools[].scaling_group.system_disk_snapshot_policy_id

worker_system_disk_performance_level

nodepools[].scaling_group.system_disk_performance_level

worker_data_disks

nodepools[].scaling_group.data_disks

worker_instance_charge_type

nodepools[].scaling_group.instance_charge_type

worker_period_unit

nodepools[].scaling_group.period_unit

worker_period

nodepools[].scaling_group.period

worker_auto_renew

nodepools[].scaling_group.auto_renew

worker_auto_renew_period

nodepools[].scaling_group.auto_renew_period

user_data

nodepools[].scaling_group.user_data

ACK 専用クラスターのマスターノードでは、このパラメーターはサポートされなくなりました。

node_name_mode

nodepools[].scaling_group.node_name_mode

ACK 専用クラスターのマスターノードでは、このパラメーターはサポートされなくなりました。

rds_instances

nodepools[].scaling_group.rds_instances

taints

nodepools[].scaling_group.taints

ACK 専用クラスターのマスターノードでは、このパラメーターはサポートされなくなりました。

instances

クラスターとノードプールを作成した後、AttachInstancesToNodePool を使用して既存のノードをノードプールに追加します。

format_disk

keep_instance_name

cloud_monitor_flags

nodepools[].kubernetes_config.cms_enabled

control_plane_config.cloud_monitor_flags

soc_enabled

nodepools[].kubernetes_config.soc_enabled

control_plane_config.soc_enabled

security_hardening_os

nodepools[].kubernetes_config.security_hardening_os

control_plane_config.security_hardening_os

cis_enabled

nodepools[].kubernetes_config.security_hardening_os

cpu_policy

CreateClusterNodePoolkubelet_config フィールドを使用して CPU ポリシーを設定します。

control_plane_config.cpu_policy

このパラメーターは非推奨です。

runtime.name

nodepools[].kubernetes_config.runtime

control_plane_config.runtime

runtime.version

nodepools[].kubernetes_config.runtime_version

image_type

nodepools[].scaling_group.image_type

control_plane_config.image_type

image_id

nodepools[].scaling_group.image_id

control_plane_config.image_id

platform

nodepools[].scaling_group.image_type

control_plane_config.image_type

os_type

nodepools[].scaling_group.os_type

key_pair

nodepools[].scaling_group.key_pair

control_plane_config.key_pair

login_password

nodepools[].scaling_group.login_password

control_plane_config.login_password

pod_vswitch_ids

Terway コンポーネントの config フィールドで指定します:

  • [VPC の作成] を選択した場合、コントロールプレーンの vSwitch リストが自動的に入力されます。

  • [既存の VPC を選択] を選択した場合は、次のフォーマットで手動で指定する必要があります:

    {
        "addons": [
            {
                "name": "terway-eniip",
                "config": "{\"PodVswitchId\":{\"cn-shanghai-b\":[\"vsw-uf6wzbnvt9n3rzp*****\"]}}"
            }
        ]
    }

custom_san

extra_sans

nat_gateway

snat_entry

service_discovery_types

private_zone 機能はサポートされなくなりました。addonsmanaged-coredns または coredns に設定して、次のフォーマットでサービスディスカバリを設定します:

  • {
       "addons": [
          {
             "name": "managed-coredns"
          }
       ]
    }
  • {
       "addons": [
          {
             "name": "coredns"
          }
       ]
    }

zone_id

zone_ids

logging_type

アドオンから loongcollector コンポーネントを次のフォーマットでインストールします:

{
   "addons": [
      {
         "name": "loongcollector"
      }
   ]
}

sls_project_name

disable_rollback

このパラメーターは非推奨です。

timeout_mins

このパラメーターは非推奨です。

access_control_list

クラスター作成後、API を介した手動設定については、「Resource Access Management」をご参照ください。

enable_rrsa

rrsa_config.enabled

DescribeClusterDetail

非推奨パラメーター

代替パラメーター

vswitch_id

vswitch_ids

worker_ram_role_name

DescribeClusterResources を使用してクエリします。

docker_version

DescribeClusterNodePoolDetail を使用してクエリします。

external_loadbalancer_id

DescribeClusterResources を使用してクエリします。

network_mode

このパラメーターは非推奨です。

subnet_cidr

container_cidr

zone_id

このパラメーターは非推奨です。

`vswitch_ids` と DescribeVSwitches を使用して関連するゾーン情報をクエリできます。

private_zone

このパラメーターは非推奨です。

parameters

このパラメーターは非推奨です。

関連する結果をクエリするには、「DescribeClusterDetail」で代替ソリューションをご参照ください。

outputs

このパラメーターは非推奨です。

関連する結果をクエリするには、「DescribeClusterDetail」と「DescribeClusterResources」をご参照ください。

upgrade_components

このパラメーターは非推奨です。

DescribeKubernetesVersionMetadata を使用してクエリします。

maintenance_info

このパラメーターは非推奨です。

next_version

DescribeKubernetesVersionMetadata を使用してクエリします。

ModifyCluster

非推奨パラメーター

代替パラメーター

instance_deletion_protection

このパラメーターは非推奨です。

ingress_loadbalancer_id

このパラメーターは非推奨です。

access_control_list

このパラメーターは非推奨です。

クラスター作成後、API を介した手動設定については、「Resource Access Management」をご参照ください。

UpgradeCluster

非推奨パラメーター

代替パラメーター

rolling_policy

ワーカーノードのアップグレードには UpgradeClusterNodepool の使用を推奨します。

rolling_policy.max_parallelism

ワーカーノードのアップグレードには UpgradeClusterNodepool の使用を推奨します。

非推奨 API とソリューション

非推奨 API

代替 API

DescribeClusters

DescribeClustersForRegion

DescribeClustersV1

GetUpgradeStatus

DescribeTaskInfo

PauseClusterUpgrade

PauseTask

CancelClusterUpgrade

CancelTask

ResumeUpgradeCluster

ResumeTask