创建弹性网卡
更新时间:2022-11-10
接口描述
本接口用来创建弹性网卡。
- 指定的内网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地址。可以为空字符串"",表示自动分配 |