为了提供更稳定的OpenAPI服务，容器服务 Kubernetes 版将从2024年11月18日起启动OpenAPI服务升级。此次升级不会改变已有OpenAPI的功能，不会影响OpenAPI的可用性。但部分OpenAPI在特定调用方式下会出现一定程度的数据更新延迟和性能波动。请参见本文了解解决方案。
影响范围
对集群进行创建、变更、删除等操作后，使用DescribeClusters或DescribeClustersV1查询集群列表时，数据更新可能出现1～10s的延迟。
使用DescribeEvents查询集群操作产生的事件时，数据更新可能出现1～10s的延迟。
使用GrantPermissions、UpdateUserPermissions更新RAM账号或RAM角色的集群访问权限后，RAM账号或RAM角色访问OpenAPI时的权限更新可能出现1～10s的延迟，但通过KubeConfig访问Kubernetes API的权限更新不受影响。
使用与集群地域不匹配的服务接入点调用OpenAPI进行集群相关操作时，OpenAPI的可用性不受影响，但OpenAPI的调用耗时将略有增加。请参见下文解决。
解决方案
使用正确的服务接入点
容器服务 Kubernetes 版为支持的每个地域提供了独立的服务接入点，请参见服务接入点。使用与集群地域匹配的服务接入点可以最大程度地保证每一次OpenAPI调用的可用性和性能。建议您检查并调整已有的OpenAPI调用代码，确保服务接入点与集群地域匹配。
对不同的OpenAPI操作类型，推荐使用的服务接入点如下表所示。
您可以在OpenAPI门户选择容器服务 Kubernetes 版提供的OpenAPI，在SDK 示例区域查看不同版本和语言SDK中设置服务接入点的方法。
操作类型 | OpenAPI示例 | 推荐使用的服务接入点 |
集群及其附属资源（节点池、组件等）、附属对象（任务、事件、应用等）的创建、查询、变更、删除操作。 |
| 与集群地域匹配的服务接入点。 |
集群操作时的元数据查询操作。 |
| 与集群地域匹配的服务接入点。 |
用户级别的配置管理操作。 |
| 非地域级别的服务接入点（cs.aliyuncs.com） |
优先使用单集群OpenAPI查询操作状态
本次更新后，涉及多个集群数据返回的OpenAPI，例如DescribeClusters、DescribeClustersV1、DescribeEvents，可能出现1～10s的数据更新延迟。请参见下表选择推荐的OpenAPI进行调用。
场景示例 | OpenAPI | 推荐方式 |
发起集群操作后查询集群状态。 | DescribeClusters、DescribeClustersV1 | DescribeClusterDetail |
发起集群操作后查询执行事件。 | DescribeEvents | DescribeClusterEvents |
使用地域级别的OpenAPI
为了提升不同地域之间的隔离性，保障OpenAPI整体可用性，容器服务 Kubernetes 版为部分OpenAPI提供了对应的地域化版本。如下表所示。
使用地域级别的OpenAPI前，您需要为调用身份增加相应OpenAPI的RAM授权。详细信息，请参见授权信息。
现有OpenAPI | 地域级别的OpenAPI | RAM操作（Action） |
DescribeClusters、DescribeClustersV1 | DescribeClustersForRegion | cs:DescribeClustersForRegion |
DescribeEvents | DescribeEventsForRegion | cs:DescribeEventsForRegion |
相关链接
您可登录OpenAPI门户进行调试。
容器服务 Kubernetes 版的API参考文档，请参见API概览。