创建弹性网卡
更新时间:2023-08-05
接口描述
本接口用来创建弹性网卡。
- 指定的内网IP必须在弹性网卡所在子网内,而且不能被占用
- 指定的IP中只能有一个是主IP,其他必须是辅助IP
- privateIpAddress为""表示自动分配IP地址
- 创建弹性网卡同时绑定已有安全组
请求结构
POST /v2/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 /v2/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地址。可以为空字符串"",表示自动分配 |