弹性网卡迁移

最近更新时间: 2024-10-17 17:10:00

1. 接口描述

本接口(MigrateNetworkInterface)用于弹性网卡迁移。 接口请求域名:vpc.api.qcloud.com

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. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见公共错误码

错误码 描述
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
        }
}