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 | CreateClusterNodePool の |
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 コンポーネントの
|
custom_san | extra_sans |
nat_gateway | snat_entry |
service_discovery_types |
|
zone_id | zone_ids |
logging_type | アドオンから |
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 | |
DescribeClustersV1 | |
GetUpgradeStatus | |
PauseClusterUpgrade | |
CancelClusterUpgrade | |
ResumeUpgradeCluster |