弹性网卡迁移

最近更新时间:2019-12-02 17:06:30

我的收藏

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

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 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
}
}