级联删除集群资源相关 OpenAPI 改造说明
最近更新时间：2023.12.21 15:56:57
首次发布时间：2023.12.19 10:59:41
本文主要介绍针对存量用户在调用 DeleteCluster、DeleteNodePool、DeleteNodes、DeleteAddon 等接口时级联删除底层资源相关能力的改造说明。
背景信息
在删除集群资源相关 OpenAPI（ DeleteCluster、DeleteNodePool、DeleteNodes、DeleteAddon ）中，原定的 CascadingDeleteResources 参数语义存在可能因为参数枚举值变更而使调用方未及时感知，从而引发资源泄露造成资损的问题。因此，容器服务（VKE）当前在删除集群资源相关 OpenAPI 中提供了语义更加准确、易用的 RetainResources 参数进行相关适配。
对于在如下时间之前已经开通了容器服务产品的 存量用户，临时性提供了 全局性删除配置 能力，支持在限定时间范围内自定义配置删除时保留资源的策略：
- 华北 2（北京）：2023 年 12 月 18 号
- 华南 1（广州）：2023 年 12 月 18 号
- 华东 2（上海）：2023 年 12 月 20 号
存量用户改造流程
阶段一：同时使用 RetainResources 和 CascadingDeleteResources 参数
存量用户在进行改造时，需要先升级 SDK，然后在调用 DeleteCluster、DeleteNodePool、DeleteNodes、DeleteAddon 接口时同时使用 RetainResources 和 CascadingDeleteResources 参数，确保兼容。
注意
- 当 RetainResources 和 CascadingDeleteResources 参数均有传入具体参数值时，以 RetainResources 参数为准。
- 容器服务相关 SDK 说明，请参见 SDK 参考。
| 场景 | RetainResources 参数 | CascadingDeleteResources 参数 |
|---|---|---|
| 删除全部资源 | 空值 | 传入：All |
保留部分资源 | 传入需要保留的资源枚举值，例如：
| 空值 |
| 保留全部资源 | 传入：All | 空值 |
| 场景 | RetainResources 参数 | CascadingDeleteResources 参数 |
|---|---|---|
| 删除资源 | 空值 | 传入：Ecs |
| 保留资源 | 传入：Ecs | 空值 |
| 场景 | RetainResources 参数 | CascadingDeleteResources 参数 |
|---|---|---|
| 删除资源 | 空值 | 传入：Crd |
| 保留资源 | 传入：Crd | 空值 |
阶段二：配置全局删除策略
如果存量用户在多个地域（Region）有 VKE 集群时，需要在所有 Region 都完成了 阶段一 的改造后，通过如下两种方式（任选一种）配置全局删除策略（DefaultDeleteAllResources）：
说明
- 完成全局删除策略的配置后，后续使用 DeleteCluster、DeleteNodePool、DeleteNodes、DeleteAddon 接口，均以 RetainResources 参数为准。
- 若您使用 Terraform，需要先升级 Terraform 至最新版本后才能配置全局删除策略。
- 在 容器服务控制台 左侧导航栏选择 全局设置，然后开启 默认删除全部资源 按钮。
- 调用 SetGlobalDefaultDeleteOption 接口，将 DefaultDeleteAllResources 参数设置为 true。
阶段三：（可选）从 OpenAPI 请求中删除 CascadingDeleteResources 参数
完成 阶段一 和 阶段二 的改造后，调用 DeleteCluster、DeleteNodePool、DeleteNodes、DeleteAddon 等删除集群资源相关 OpenAPI 时，从请求参数中直接删除 CascadingDeleteResources 参数。