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

创建弹性网卡

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

1. 接口描述

本接口(CreateNetworkInterface)用于创建弹性网卡。 接口请求域名：vpc.api.qcloud.com

1) 创建弹性网卡时可以指定内网IP，并且可以指定一个主IP，指定的内网IP必须在弹性网卡所在子网内，而且不能被占用。 2) 创建弹性网卡时可以指定需要申请的内网IP数量，系统会随机生成内网IP地址。 3) 创建弹性网卡同时可以绑定已有安全组。

2. 输入参数

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

参数名称 必选 类型 描述
vpcId 是 String 弹性网卡所在的私有网络ID，推荐使用新ID，例如：vpc-7t9nf3pu。
subnetId 是 String 弹性网卡所在的子网ID，推荐使用新ID，例如：subnet-0ap8nwca。
eniName 是 String 弹性网卡名称，可任意命名，但不得超过60个字符。
eniDescription 否 String 弹性网卡描述，可任意命名，但不得超过60个字符。
privateIpAddressSet.n 否 Array 指定的内网IP地址数组。
privateIpAddressSet.n.primary 是 Bool 是否为主IP，只能设置一个主IP。
privateIpAddressSet.n.privateIpAddress 是 String 指定的内网IP地址。
secondaryPrivateIpAddressCount 否 Int 需要新申请的内网IP地址个数。
sgIds.n 否 Array 指定绑定的安全组，例如:['sg-1dd51d']。

3. 输出参数

参数名称 类型 描述
code Int 错误码。0: 成功, 其他值: 失败
message String 错误信息
taskId Int 任务ID，操作结果可以用taskId查询，详见查询任务执行结果接口。

4. 错误码表

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

错误码 描述
InvalidVpc.NotFound 无效的VPC，VPC资源不存在。请再次核实您输入的资源信息是否正确，可通过 DescribeVpcEx 接口查询VPC
InvalidSubnet.NotFound 无效的子网，子网资源不存在。请再次核实您输入的资源信息是否正确，可通过 DescribeSubnetEx 接口查询子网
InvalidNetworkInterfaceName 弹性网卡名称不合法。可任意命名，但不得超过60个字符。
NetworkInterfaceLimitExceeded 创建的弹性网卡数量超过上限。如果需要更多资源，请联系客服申请。更多VPC资源限制信息详见VPC使用限制

5. 示例

输入

https://vpc.api.qcloud.com/v2/index.php?Action=CreateNetworkInterface
&<公共请求参数>
&vpcId=vpc-7t9nf3pu
&subnetId=subnet-0ap8nwca
&eniName=eni
&secondaryPrivateIpAddressCount=1
&sgIds.0=sg-1dd51d

输出

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