[Product Changes] Notice on ACK API updates

Container Service for Kubernetes To provide a more stable OpenAPI service, Container Service for Kubernetes (ACK) will upgrade its OpenAPI architecture starting November 18, 2024. The upgrade does not change existing OpenAPI functionality or affect availability, but some APIs may show data update delays and performance fluctuations under specific call patterns. See this notice for mitigation steps.

Scope of impact

After you create, modify, or delete a cluster, DescribeClusters and DescribeClustersV1 may reflect the change with a 1–10 second delay.
DescribeEvents may return cluster event data with a 1–10 second delay.
After you call GrantPermissions or UpdateUserPermissions to modify cluster access permissions of a RAM user or RAM role, Kubernetes API-related permission data may update with a 1–10 second delay. Permissions queried via kubeconfig are unaffected.
Using an endpoint that does not match the cluster's region does not affect API availability, but may slightly increase API call latency.

Solutions

Use the right endpoint

Container Service for Kubernetes provides region-specific endpoints. Match the endpoint to your cluster's region for optimal API performance.

Select an endpoint based on the API operation type.

Note

Select a Container Service for Kubernetes API operation in the OpenAPI Explorer console, then check the SDK Sample Code tab for endpoint configuration by SDK version and language.

API operation	Example	Suggested endpoint
Create, query, modify, and delete clusters, resources (such as node pools and components), and objects (such as jobs, events, and applications).	CreateCluster DeleteCluster DescribeClusterDetail CreateClusterNodePool DescribeClusterNodePools AttachInstancesToNodePool InstallClusterAddons ListClusterAddonInstances CreateTrigger TagResources DescribeClusterEvents DescribeTaskInfo PauseTask DescribePolicyInstances	Region-specific endpoint.
Query the metadata of cluster operations.	DescribeKubernetesVersionMetadata ListAddons DescribePolicies	Region-specific endpoint.
Manage user-level configurations.	GrantPermissions DescribeUserPermission UpdateUserPermissions DescribeUserQuota DescribeEvents CreateTemplate DescribeTemplates	Non-region-level endpoint (cs.aliyuncs.com).

Query status with single-cluster API operations

After this update, multi-cluster API operations such as DescribeClusters, DescribeClustersV1, and DescribeEvents may return data with a 1–10 second delay. Use the single-cluster alternatives below.

Scenario	API operation	Suggest API operation
Query cluster status after an operation.	DescribeClusters and DescribeClustersV1	DescribeClusterDetail
Query cluster events after an operation.	DescribeEvents	DescribeClusterEvents

Use region-level API operations

Container Service for Kubernetes provides region-level versions of some API operations for better cross-region data isolation and availability.

Important

Before calling a region-level API operation, complete RAM authorization for the identity you use.

Current API operation	Region-level API operation	Action in a RAM policy
DescribeClusters and DescribeClustersV1	DescribeClustersForRegion	cs:DescribeClustersForRegion
DescribeEvents	DescribeEventsForRegion	cs:DescribeEventsForRegion

References

Log on to the OpenAPI Explorer console to debug API operations.
See API overview for the complete Container Service for Kubernetes API reference.