一、1. 接口描述
2. 迁移前后的云服务器必须是停机或者运营中状态,查看云服务器状态详见 查看腾讯云服务器信息。
3. 迁移后云服务器必须属于 VPC 子机,迁移后云服务器可用区必须和网卡可用区相同。
二、2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 MigrateNetworkInterface。
| 参数名称 | 必选 | 类型 | 描述 |
| vpcId | 是 | String | 弹性网卡对应的私用网络 ID,例如:vpc-7t9nf3pu。 |
| networkInterfaceId | 是 | String | 弹性网卡 ID,例如:eni-m6dyj72l。 |
| oldInstanceId | 是 | String | 迁移前的云服务器实例 ID,例如:ins-xx44545f。 |
| newInstanceId | 是 | String | 迁移后的云服务器实例 ID,例如:ins-xx44545f。 |
三、3. 输出参数
| 参数名称 | 类型 | 描述 |
| code | Int | 错误码。0:成功,其他值:失败。 |
| message | String | 错误信息。 |
| taskId | Int | 任务ID,操作结果可以用 taskId 查询,详见 查询任务执行结果接口。 |
四、4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码。
| 错误码 | 描述 |
| InvalidVpc.NotFound | 无效的 VPC,VPC 资源不存在。请再次核实你输入的资源信息是否正确,可通过 DescribeVpcEx 接口查询 VPC。 |
| InvalidNetworkInterface.NotFound | 无效的弹性网卡,弹性网卡资源不存在。请再次核实你输入的资源信息是否正确,可通过 DescribeNetworkInterfaces 接口查询弹性网卡。 |
| InvalidInstance.NotFound | 无效的云服务器实例,云服务器实例资源不存在。请再次核实你输入的资源信息是否正确,可通过 DescribeInstances 接口查询云服务器实例。 |
| InvalidNetworkInterface.AlreadyAssociated | 弹性网卡和云服务器已绑定。 |
五、5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=MigrateNetworkInterface&<公共请求参数>&vpcId=vpc-xx44545f&networkInterfaceId=eni-m6dyj72l&oldInstanceId=ins-xx44545f&newInstanceId=ins-cddddu74
输出
{ "code": 0, "message": "", "codeDesc": "Success", "data": { "taskId": 16284 }}