创建弹性网卡
更新时间:2025-08-05
接口描述
本接口用来创建弹性网卡。
- 指定的内网IP必须在弹性网卡所在子网内,而且不能被占用
- 指定的IP中只能有一个是主IP,其他必须是辅助IP
- privateIpAddress为""表示自动分配IP地址
- 创建弹性网卡同时绑定已有安全组
请求结构
                JSON
                
            
            1POST /v1/vpc/eni HTTP/1.1     
2Host: bec.baidubce.com     
3Authorization: authorization string     
4{
5    "name": "eniname",
6    "description": "enitest",
7    "privateIpSet": [
8        {
9            "primary": true,
10            "privateIpAddress": ""
11        }
12    ],
13    "securityGroupIds": ["sg-xxxxxx"],
14    "subnetId": "sbn-1"
15}请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 | 
|---|---|---|---|---|
| name | String | 是 | Request Body参数 | 弹性网卡名称,长度不超过65个字符,可由数字、字符、下划线组成 | 
| description | String | 否 | Request Body参数 | 描述,不超过200字符 | 
| subnetId | String | 是 | Request Body参数 | 弹性网卡所属的子网ID | 
| securityGroupIds | String | 是 | Request Body参数 | 指定绑定的安全组集合 | 
| privateIpSet | List<PrivateIp> | 是 | Request Body参数 | 指定的内网IP信息 | 
| clientToken | String | 否 | Query参数 | 幂等性Token,是一个长度不超过64位的ASCII字符串 | 
返回头域
除公共头域,无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 | 
|---|---|---|
| result | Boolean | 操作是否成功,true表示成功;false表示失败 | 
| details | Map | 返回结果,包含eniId表示弹性网卡ID,类型为String | 
请求示例
                JSON
                
            
            1 POST /v1/vpc/eni HTTP/1.1        
2 Host: bec.baidubce.com     
3 ContentType: application/json     
4 Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2015 08 11T04:17:29Z/3600/host/uuid   
5
6 {
7    "description": "enidesc",
8    "name": "eniname",
9    "privateIpSet": [
10        {
11            "primary": true,
12            "privateIpAddress": ""
13        },
14        {
15            "primary": false,
16            "privateIpAddress": ""
17        }
18    ],
19    "securityGroupIds": ["sg-aopugxjk"],
20    "subnetId": "sbn-zj5fjaf1fg1k"
21}     返回示例
                JSON
                
            
            1 HTTP/1.1 200 OK     
2 x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3 Date: Thu, 16 Mar 2022 06:29:48 GMT      
4 Content Type: application/json;charset=UTF 8     
5 Server: BWS     
6
7 {
8    "result": true,
9    "action": "create",
10    "details": {
11        "eniId": "eni-bd5onybc1g5f"
12    }
13 }Modal对象定义
PrivateIp
| 参数名称 | 类型 | 是否必选 | 描述 | 
|---|---|---|---|
| primary | Boolean | 是 | 是否主IP | 
| privateIpAddress | String | 是 | 内网IPv4地址。可以为空字符串"",表示自动分配 | 
