调用MigrateDBCluster将数仓版迁移至湖仓版或企业版集群。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| adb:MigrateDBCluster | update | *DBCluster acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| DBClusterId | string | 是 | 数仓版集群 ID。 | am-bp1xxxxxxxx47 |
| ComputeResource | string | 否 | 计算预留资源。取值范围：0ACU～4096ACU，步长：16。1 ACU 约等于 1 核 4 GB。 说明
参数填写时，需要带单位，仅 ProductForm 取值为 LegacyForm 时，填写该参数。
| 32ACU |
| StorageResource | string | 否 | 存储预留资源。取值范围：0ACU～2064ACU，步长等于 StorageResourceSize 参数指定 ACU 数 * 3 （默认 24ACU）。1 ACU 约等于 1 核 4 GB。 说明
参数填写时，需要带单位，仅 ProductForm 取值为 LegacyForm 时，填写该参数。
| 24ACU |
| StorageResourceSize | string | 否 | 存储预留资源节点规格，支持 8ACU，12ACU，16ACU 说明
参数填写时，需要带单位，仅 ProductForm 取值为 LegacyForm 时，填写该参数。
| 8ACU |
| ShardNumber | string | 否 | 分片数。指定迁移同时修改实例分片（Shard）数目。 说明
仅 ProductForm 取值为 LegacyForm 时，填写该参数。
| 128 |
| ReservedNodeSize | string | 否 | 存储预留资源节点规格，支持 8ACU，12ACU，16ACU 说明
参数填写时，需要带单位，仅 ProductForm 取值为 IntegrationForm 时，填写该参数。
| 8ACU |
| ReservedNodeCount | integer | 否 | 预留节点数。
说明
仅 ProductForm 取值为 IntegrationForm 时，填写该参数
| 3 |
| ProductVersion | string | 否 | 产品版本。取值为：
说明
仅 ProductForm 取值为 IntegrationForm 时，填写该参数
| EnterpriseVersion |
| ProductForm | string | 否 | 产品形态。取值为：
| LegacyForm |
| SecondaryZoneId | string | 否 | 备可用区 ID。 说明
本参数和 ZoneId 属性不能相同。
| cn-beijing-h |
| SecondaryVSwitchId | string | 否 | 备虚拟交换机 ID。 说明
本参数和 VSwitchId 属性不能相同。
| vsw-bp1aadw9k19x451gx**** |
| DryRun | boolean | 否 | 是否只预检此次请求, 默认为 false。取值范围：
| false |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "F0983B43-B2EC-536A-8791-142B5CF1E9B6"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | IncorrectDBInstanceState | The specified instance state does not support this operation. | 实例状态不允许该操作 |
| 404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-08-15 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |