租户端 网络 私有网络（VPC） 历史版本（V2接口）

弹性网卡绑定云服务器

最近更新时间: 2024-06-12 15:06:00

1. 接口描述

本接口(AttachNetworkInterface)用于弹性网卡申请内网Ip。 接口请求域名：vpc.api.qcloud.com

1) 一个云服务器可以绑定多个弹性网卡，但只能绑定一个主网卡。更多vpc资源限制信息详见VPC使用限制。 2) 一个弹性网卡只能同时绑定一个云服务器。 3) 只有运行中或者已关机状态的云服务器才能绑定弹性网卡，查看云服务器状态详见查看云服务器信息。 4) 弹性网卡绑定的云服务器必须是私有网络的，而且云服务器所在可用区必须和弹性网卡子网的可用区相同。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见公共请求参数页面。其中，此接口的Action字段为AttachNetworkInterface。

参数名称 必选 类型 描述
vpcId 是 String 弹性网卡对应的私用网络ID，例如：vpc-7t9nf3pu
networkInterfaceId 是 String 弹性网卡ID，例如：eni-m6dyj72l
instanceId 是 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=AttachNetworkInterface
&<公共请求参数>
&vpcId=vpc-xx44545f
&networkInterfaceId=eni-m6dyj72l
&instanceId=ins-xx44545f

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data":
        {
            "taskId": 16284
        }
}