创建弹性网卡
更新时间：2022-11-10
接口描述
本接口用来创建弹性网卡。
- 指定的内网IP必须在弹性网卡所在子网内，而且不能被占用
- 指定的IP中只能有一个是主IP，其他必须是辅助IP
- privateIpAddress为""表示自动分配IP地址
- 创建弹性网卡同时绑定已有安全组
请求结构
POST /v1/vpc/eni HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
{
"name": "eniname",
"description": "enitest",
"privateIpSet": [
{
"primary": true,
"privateIpAddress": ""
}
],
"securityGroupIds": ["sg-xxxxxx"],
"subnetId": "sbn-1"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 |
请求示例
POST /v1/vpc/eni HTTP/1.1
Host: bec.baidubce.com
ContentType: application/json
Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2015 08 11T04:17:29Z/3600/host/uuid
{
"description": "enidesc",
"name": "eniname",
"privateIpSet": [
{
"primary": true,
"privateIpAddress": ""
},
{
"primary": false,
"privateIpAddress": ""
}
],
"securityGroupIds": ["sg-aopugxjk"],
"subnetId": "sbn-zj5fjaf1fg1k"
} 返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
Date: Thu, 16 Mar 2022 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{
"result": true,
"action": "create",
"details": {
"eniId": "eni-bd5onybc1g5f"
}
}Modal对象定义
PrivateIp
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| primary | Boolean | 是 | 是否主IP |
| privateIpAddress | String | 是 | 内网IPv4地址。可以为空字符串""，表示自动分配 |