本文主要记录容器服务 OpenAPI 正式对外发布后的变更记录。

2026年10月

API	发布时间	变更记录	关联功能
CreateKubernetesObservability	2026-10-08	新增集群可观测 API。	集群可观测
ListKubernetesObservability	2026-10-08	新增集群可观测 API。	集群可观测

2026年09月

API	发布时间	变更记录	关联功能
UpdateNodePoolNodesConfig	2026-09-25	新增更新节点配置 API。	节点池管理。
CreateNodePool			NodePoolKubeletConfig 结构中新增 PodPidsLimit、ImageMaximumGcAge 和 ImageMinimumGcAge 参数。 NodePoolContainerdConfig 结构中新增 UseLocalImagePull、MaxConcurrentUnpacks、MaxConcurrentDownloads 和 ConcurrentLayerFetchBuffer 参数。	节点池管理。
UpdateNodePoolConfig
ListNodePools
CreateAddon			更新 p2p-accelerator 组件的配置参数说明和示例。	组件管理。
CreateNodes	2026-09-10	新增 ContainerStorageMountPoint 参数。	节点管理。
DeleteNodes	2026-09-10	新增 Drain 参数。	节点管理。
CreateDiagnosticTask	2026-09-09	新增巡检诊断 API。	巡检诊断。
ListDiagnosticTask
ListDiagnosticTaskResults
CreateInspectionPolicy
ListInspectionPolicies
UpdateInspectionPolicy
DeleteInspectionPolicy
CreateRemedyRule
UpdateRemedyRule
DeleteRemedyRule
UpdateClusterVersion	2026-09-01	新增集群升级 API。	集群升级管理。
UpgradeNodePools	2026-09-01	新增集群升级 API。	集群升级管理。
UpdateTask	2026-09-01	新增任务管理 API。	任务管理。
ListTasks	2026-09-01	新增任务管理 API。	任务管理。

2026年08月

API	发布时间	变更记录	关联功能
CreateNodePool	2026-08-31	NodePoolKubeletConfig 结构中新增 FailSwapOn、ImageGcLowThresholdPercent 和 ImageGcHighThresholdPercent 参数。 NodePoolNodeConfigRequest.SpotStrategy 结构中新增 SpotWithPriceLimit 取值。 NodePoolNodeConfigRequest 结构中新增 SpotPriceLimits 参数。 DataVolume 结构中新增 KmsKeyId 和 Encrypted 参数。新增 InstanceTypeSpotPriceLimit 及其子参数。	节点池管理。
UpdateNodePoolConfig
ListNodePools
UpdateKubernetesObservabilityComponentConfigs	2026-08-25	新增云原生观测管理 API。	组件管理。

2026年07月

API	发布时间	变更记录	关联功能
CreateCluster	2026-07-30	新增 MaintenanceWindowConfig 及其子参数。	集群运维管理。
UpdateNodePoolConfig
ListClusters
CreateNodePool	2026-07-21	SystemVolume 结构中新增 BurstEnabled 参数。 DataVolume 结构中新增 BurstEnabled 参数。	节点池管理。
UpdateNodePoolConfig
ListNodePools
CreateCluster	2026-07-17	新增 KubernetesConfig 及其子参数。	集群控制面管理。
UpdateNodePoolConfig	2026-07-17	新增 KubernetesConfig 及其子参数。	集群控制面管理。
ListClusters	2026-07-17	新增 KubernetesConfig 及其子参数。 Tags 结构中新增 Values 参数。	集群控制面管理。
CreateAddon	2026-07-02	新增 cr-signature-verifier 组件配置文件说明。	组件管理。
ScaleNodePool	2026-07-02	新增接口。	节点池管理。
CreateNodePool	2026-07-02	新增 GpuDriverConfig 参数。废弃原有 GpuDriverVersion 参数。	节点池管理。
UpdateNodePoolConfig
CreateNodes

2026年05月

API	发布时间	变更记录	关联功能
CreateNodePool	2026-05-28	新增 BandwidthPackageId 参数。	节点池管理。
UpdateNodePoolConfig
ListNodePools
CreateScalingPolicy	2026-05-26	新增 Name 参数。	节点池管理。
UpdateScalingPolicy	2026-05-26
ListScalingPolicies	2026-05-26
CreateNodePool	2026-05-06	新增 Runtime 及其子参数。新增 AffinityGroupConfig 及其子参数。 DataVolume 结构中新增 ExtraPerformanceIops、ExtraPerformanceTypeId 和 ExtraPerformanceThroughputMb 参数。	节点运行时管理。节点池和节点亲和组管理。
UpdateNodePoolConfig
ListNodePools
CreateDefaultNodePool	2026-05-06	新增 Runtime 及其子参数。	节点运行时管理。
CreateNodes	2026-05-06	新增 AffinityGroupConfig 及其子参数。	节点池和节点亲和组管理。
ListNodes
DeleteNodes
ListSupportedImages	2026-05-06	新增 Intersection 和 KubernetesVersion 参数。	机型镜像管理。

2026年04月

API	发布时间	变更记录	关联功能
CreateNodePool	2026-04-03	更新 HpcClusterIds 参数描述。	节点池管理。
UpdateNodePoolConfig	2026-04-03	更新 HpcClusterIds 参数描述。	节点池管理。

2026年02月

API	发布时间	变更记录	关联功能
ListClusters	2026-02-27	新增 VciSubnetIds 参数。	集群管理。
UpdateClusterConfig	2026-02-27	新增 VciSubnetIds 参数。	集群管理。

2026年01月

API	发布时间	变更记录	关联功能
CreateNodePool	2025-01-18	新增 GpuDriverVersion 参数。	节点池管理。
UpdateNodePoolConfig
ListNodePools
CreateNodes
ListSupportedGpuDriverVersions	2025-01-18	新增获取镜像支持安装的 GPU 驱动版本列表 API。	节点池管理。
CreateNodePool	2025-01-08	DataVolume.Type 结构中新增LOCAL_SSD、LOCAL_HDD、LOCAL_LVM_SSD、LOCAL_SSD_SRIOV 取值。	节点池管理。
UpdateNodePoolConfig	2025-01-08		节点池管理。
ListNodePools	2025-01-08	DataVolume.Type 结构中新增LOCAL_SSD、LOCAL_HDD、LOCAL_LVM_SSD、LOCAL_SSD_SRIOV 取值。 Conditions.Type 参数新增ScalingFailed取值。	节点池管理。
CreateNodes	2025-01-08	新增 SkipReplaceSystem 参数。	节点管理。
CreateAddon	2025-01-08	更新 cluster-autoscaler 组件配置，新增 MaxNodeProvisionTime、ScaleDown.IgnoreDaemonSetsUtilizationEnabled、ScaleDown.ScaleDownDelayTypeLocalEnabled 参数。	组件管理。

2025年12月

API	发布时间	变更记录	关联功能
CreateNodePool	2025-12-02	新增 ContainerdConfig 及其子参数。 SystemVolume.Type 结构中新增Ultra_Disk、TSSD_TL0取值。 DataVolume.Type 结构中新增Ultra_Disk、TSSD_TL0取值。删除如下错误码： InstanceChargeTypeMismatch.PublicAccessEnabled SpotStrategyMismatch.PublicAccessEnabled	节点池管理。
UpdateNodePoolConfig	2025-12-02	新增 ContainerdConfig 及其子参数。 SystemVolume.Type 结构中新增Ultra_Disk、TSSD_TL0取值。 DataVolume.Type 结构中新增Ultra_Disk、TSSD_TL0取值。 NodeConfigForUpdate.InstanceChargeType 参数描述更新，包年包月节点池支持节点自动绑定公网 IP 功能，删除相关限制描述。删除如下错误码： InstanceChargeTypeMismatch.PublicAccessEnabled SpotStrategyMismatch.PublicAccessEnabled
ListNodePools	2025-12-02	新增 ContainerdConfig 及其子参数。
ListClusters	2025-12-02	ClusterStatusFilter 以及 ClusterStatusCondition 下的 Conditions.Type 参数新增如下枚举值： UpdatingCluster SyncingAddon SyncingNode SyncingNodePool	集群管理。

2025年11月

API	发布时间	变更记录	关联功能
CreateNodePool	2025-11-30	DataVolume.Type 参数中新增RSSD_PL0取值，允许在创建或更新节点池时，为数据盘配置性能级别为 PL0 的弹性远程盘。	节点池管理。
UpdateNodePoolConfig	2025-11-30		节点池管理。
UpdateClusterConfig	2025-11-26	新增 EnableMetricsExternalCollection 参数，允许开启集群控制面组件自定义采集功能。	集群管理。
UpdateClusterConfig	2025-11-18	新增 ResourcePublicAccessDefaultEnabled 参数，允许关闭集群公网访问功能。新增 MonitoringConfig 参数，允许配置集群监控配置。	集群管理。
CreateNodePool	2025-11-04	新增InstanceChargeTypeMismatch.AutoScalingEnabled错误码。	节点池管理。
UpdateNodePoolConfig	2025-11-04		节点池管理。	新增 InstanceChargeType 参数。新增如下两个错误码： InstanceChargeTypeMismatch.AutoScalingEnabled InstanceChargeTypeMismatch.SpotStrategy
ListSupportedImages	2025-11-04	新增机型镜像管理 API。	节点池对应规格与镜像管理。
ListInstanceTypeLabels
ListSupportedAddInstanceTypes

2025年10月

API	发布时间	变更记录	关联功能
CreateNodePool	2025-10-22	新增 Management 及其子参数，支持配置托管节点池。	托管节点池。
UpdateNodePoolConfig
ListNodePools
CreateScalingPolicy	2025-10-21	新增节点池弹性预约伸缩规则 API。	节点池弹性预约伸缩。
UpdateScalingPolicy
ListScalingPolicies
DeleteScalingPolicies
CreateCluster	2025-10-17	LogType 参数新增支持如下取值： Etcd ClusterAutoscaler	集群的日志配置。
UpdateClusterConfig	2025-10-17		LogType 参数新增支持如下取值： Etcd ClusterAutoscaler 请求参数新增 IrsaEnabled 参数。	集群的日志配置。集群支持开启 IRSA 功能。

2025年07月

API	发布时间	变更记录	关联功能
CreateNodePool	2025-07-30	NodePoolKubeletConfig 结构中新增如下配置：新增MaxPods字段，用于配置节点支持的最大 Pod 数量。新增KubeApiQps和KubeApiBurst字段，用于配置每秒发送到 APIServer 的请求数和突发请求数阈值。新增EvictionHard字段，用于配置触发 Pod 驱逐操作的一组硬性门限。新增KubeReserved和SystemReserved字段，用于配置节点预留给 Kubernetes 系统和组件的资源。新增RegistryPullQps和RegistryBurst字段，用户配置集群从镜像仓库拉取镜像的 QPS 和突发阈值。新增SerializeImagePulls字段，用于配置是否串行拉取镜像。新增CpuManagerPolicy字段，用于配置 CPU 管理器策略。	配置节点 Kubelet 参数。
UpdateNodePoolConfig
ListNodePools

2024年12月

API	发布时间	变更记录	关联功能
GrantPermission	2024-12-03	新增 RBAC 访问策略管理 API。	容器服务支持为 IAM 用户和 IAM 角色配置 RBAC 权限。
ListPermissions
RevokePermission

2024年11月

API	发布时间	变更记录	关联功能
CreateImageCache	2024-11-25	新增 RegistryHostnameResolvNameservers 参数。	镜像缓存支持自定义 DNS。
UpdateImageCache	2024-11-25	新增 RegistryHostnameResolvNameservers 参数。	镜像缓存支持自定义 DNS。

2024年07月

API	发布时间	变更记录	关联功能
CreateNodes	2024-07-30	更新 NodePoolId 参数描述，添加已有节点时支持保留原云服务器（ECS）实例名称。	添加已有节点时支持保留原云服务器（ECS）实例名称。

2024年01月

API	发布时间	变更记录	关联功能
CreateCluster	2024-01-19	新增错误码 Insufficient.SubnetIp、LimitExceeded.ClusterSubnetZones、LimitExceeded.ClusterSubnetsOfZone。	集群支持修改 API Server 子网。
UpdateClusterConfig	2024-01-19		集群支持修改 API Server 子网。	ClusterConfig 结构下新增 SubnetIds 字段。新增错误码 Insufficient.SubnetIp、LimitExceeded.ClusterSubnetZones、LimitExceeded.ClusterSubnetsOfZone。
CreateNodePool	2024-01-19	KubernetesConfig 结构下新增 NamePrefix 字段。	支持自定义元数据名称前缀。
ListNodePools	2024-01-19	KubernetesConfig 结构下新增 NamePrefix 字段。	支持自定义元数据名称前缀。
ListKubeconfigs	2024-01-19	Filter 参数下新增 RoleIds 字段。	支持为 IAM 角色授予集群的 RBAC 权限。
CreateAddon	2024-01-19	更新 cluster-autoscaler 组件配置，新增 ScaleDownGpuUtilizationThreshold 参数。	CA 新增支持 GPU 缩容阈值配置。

2023年12月

API	发布时间	变更记录	关联功能
DeleteCluster	2023-12-18	新增 RetainResources 参数，同时即将弃用 CascadingDeleteResources 参数。	改造删除集群资源相关 OpenAPI。
DeleteNodePool
DeleteNodes
DeleteAddon
CreateAddon	2023-12-01	更新 prometheus-agent 组件和 nvidia-device-plugin 组件配置。	优化组件配置项名称。

2023年11月

API	发布时间	变更记录	关联功能
CreateAddon	2023-11-09	更新 mgpu 组件、p2p-accelerator 组件、prometheus-adapter 组件配置。	优化组件配置项名称。

2023年10月

API	发布时间	变更记录	关联功能
CreateNodes	2023-10-30	新增错误码 OperationDenied.NodePoolReplicas。	优化产品 API 能力。
DeleteNodes	2023-10-30	新增错误码 OperationDenied.NodePoolReplicas。	优化产品 API 能力。

2023年05月

API	发布时间	变更记录	关联功能
CreateNodePool	2023-05-06	新增错误码 ClusterVersionMismatch.ImageId。	部分规格的节点镜像，支持 veLinux CentOS 兼容版操作系统能力。
UpdateNodePoolConfig
CreateNodes
CreateAddon			更新 prometheus-agent 组件配置。	优化组件相关代码。

2023年04月

API	发布时间	变更记录	关联功能
API 列表	2023-04-30	容器服务 OpenAPI 文档正式对外发布。	文档正式对外发布。