将一个或多个实例，从当前的归属机房（Dc）迁移至相同区域（Zone）内的另一个指定机房，即改变实例的开机和运行机房。
迁移后，实例的 ID 和属性值保持不变。

使用说明

本地存储业务

• 使用本接口迁移实例前，必须先将实例数据备份至云盘。具体操作参考 BackupPod 接口说明。
• 支持将实例迁移至相同规格的机房中运行，同时也支持将实例迁移至不同于原规格的机房中运行，以实现实例规格的升配或降配。例如，可以将“旗舰型”实例迁移到能够运行“旗舰型plus”实例的机房，反之亦然。但请注意：
  • 按照云机规格的 ServerTypeCode 参数值将云机规格分为以下两类，其中 g2 类型 和 g3 类型 之间不支持跨类型迁移，即实例属于 g2 类型 时不支持迁移至 g3 类型 的机房，反之亦然。关于云机规格的 ServerTypeCode 参数说明，请参见本地存储资源规格。
    • g2 类型：云机规格的 ServerTypeCode 参数值为 g2.8c12g、g2.8c16g.basic、g2.8c16g.plus
    • g3 类型：云机规格的 ServerTypeCode 参数值为 g3.host8c24g256g
  • 迁移完成后，为确保实例能够再次正常启动和运行，需完成以下操作：
    1. 调用 UpdatePod 接口，将实例规格更改为目标机房可运行的实例规格（需要注意变更前实例已使用的存储容量需要小于目标实例规格存储容量的 80%）。
    2. 调用 RestorePod 接口，将实例数据从云盘还原至云机本地存储中。

云盘存储业务

• 使用本接口迁移实例前，请确保实例处于“已关机”状态。
• 支持将实例迁移至相同规格的机房中运行，同时也支持将实例迁移至不同于原规格的机房中运行，以实现实例规格的升配或降配。例如，可以将“旗舰型”实例迁移到能够运行“旗舰型plus”实例的机房，反之亦然。但请注意，迁移完成后，为确保实例能够再次正常启动和运行，必须先调用 UpdatePod接口，将实例规格更改为目标机房可运行的实例规格，才可正常开机。

注意事项

1. 实例仅限于在同一区域（Zone）内的不同机房（Dc）间迁移，暂不支持跨区域迁移。可调用 ListDc 接口，通过返回的 Zone 参数判断。
2. 单次接口调用支持迁移的实例数量上限为 100。
3. 本接口的单用户 QPS 限制为 5 次/秒。超过限制，API 调用会被限流。

请求说明

• 请求方式：POST
• 请求地址：https://open.volcengineapi.com?Action=MigratePod&Version=2025-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

MigratePodDetail

请求示例

POST https://open.volcengineapi.com?Action=MigratePod&Version=2025-05-01
{
    "ProductId": "1635714550******",
    "PodIdList": [
        "7343627425983******",
        "7343627426314******"
    ],
    "TargetDc": "gdsz-ctcucm-01-lw******"
}

返回示例

{
    "ResponseMetadata": {
        "Action": "MigratePod",
        "Region": "cn-north-1",
        "Service": "ACEP",
        "Version": "2025-05-01",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "ProductId": "1846027434848******",
        "Details": [
            {
                "PodId": "7343627425983******",
                "Success": false,
                "ErrCode": 8060001,
                "ErrMsg": "get record from database failed:record not found"
            },
            {
                "PodId": "7343627426314******",
                "Success": true,
                "ErrCode": 0,
                "ErrMsg": ""
            }
        ]
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。