弹性网卡
初始化
确认Endpoint
在确认您使用SDK,需要配置Endpoint时,理解Endpoint相关的概念。 百度智能云目前开放了多区域支持,请参考区域选择说明。 目前支持“华北-北京”、“华南-广州”、"华东-苏州"、"香港"、"金融华中-武汉"和"华北-保定"六个区域。对应Endpoint信息为:
| 访问区域 | 对应Endpoint | 
|---|---|
| 华北-北京 | bcc.bj.baidubce.com | 
| 华南-广州 | bcc.gz.baidubce.com | 
| 华东-苏州 | bcc.su.baidubce.com | 
| 香港 | bcc.hkg.baidubce.com | 
| 金融华中-武汉 | bcc.fwh.baidubce.com | 
| 华北-保定 | bcc.bd.baidubce.com | 
获取密钥
要使用百度智能云安全组,您需要拥有一个有效的 AK(Access Key ID)和SK(Secret Access Key)用来进行签名认证。AK/SK是由系统分配给用户的,均为字符串,用于标识用户,为访问BOS做签名验证。 可以通过如下步骤获得并了解您的AK/SK信息: 注册百度智能云账号 创建AK/SK
新建EniClient
EniClient是ENI服务的客户端,为开发者与ENI服务进行交互提供了一系列的方法。
新建EniClien时,需要先使用Endpoint、AK、SK对AclClientConfiguration类型config实例进行配置,再使用config实例对EniClien进行配置,配置示例如下:
1 static final String HOST = "";
2 static final String AK = "";
3 static final String SK = "";
4 EniClientConfiguration config = new EniClientConfiguration();
5 config.setCredentials(new DefaultBceCredentials(AK, SK));
6 config.setEndpoint(HOST);
7 EniClien eniClient = new EniClien(config);
            新建弹性网卡
函数声明
1public CreateEniResponse createEni(CreateEniRequest request) {
2 }
            参数含义
请参考OpenAPI文档 创建Eni请求参数
返回值
- 操作成功
 
1{
2    "metadata":"metadata格式参考附录metadata部分",
3    "eniId":"eni-58djsuahfkj"
4}
            - 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleCreateEni.java
更新弹性网卡
函数声明
1 public void updateEni(EniUpdateRequest request) {
2 }
            参数含义
请参考OpenAPI文档 更新Eni请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleUpdateEni.java
删除弹性网卡
函数声明
1 public void deleteEni(String eniId) {
2 }
            参数含义
请参考OpenAPI文档 删除Eni请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleDeleteEni.java
查询弹性网卡列表
函数声明
1public ListEniResponse listEni(ListEniRequest request) {
2 }
            参数含义
请参考OpenAPI文档 List Eni请求参数
返回值
- 操作成功
 
1{
2    "metadata":"metadata格式参考附录metadata部分",
3    "maxKeys": 1000,
4    "isTruncated": false,
5    "enis": [
6        {
7            "eniId": "eni-hkd58ti0vc6e",
8            "name": "testEni",
9            "vpcId": "vpc-b9ycwxxisrb7",
10            "subnetId": "sbn-6ha6gp1vczuv",
11            "zoneName": "cn-bj-a",
12            "description": "desc",
13            "createdTime": "2023-12-04T02:58:44Z",
14            "macAddress": "fa:f6:00:13:7f:ba",
15            "status": "available",
16            "networkInterfaceTrafficMode": "standard",
17            "privateIpSet": [
18                {
19                    "primary": true,
20                    "privateIpAddress": "192.168.0.8"
21                }
22            ],
23            "ipv6PrivateIpSet": []
24        }
25    ]
26}
            - 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleListEni.java
增加弹性网卡内网IP
函数声明
1 public void addPrivateIp(EniPrivateIpOperateRequest request) {
2 }
            参数含义
请参考OpenAPI文档 创建Eni内网IP请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniAddPrivateIp.java
删除弹性网卡内网IP
函数声明
1public void deletePrivateIp(EniPrivateIpOperateRequest request) {
2 }
            参数含义
请参考OpenAPI文档 删除Eni内网IP请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniDelPrivateIp.java
查询指定的弹性网卡
函数声明
1public EniDetail getEniDetail(GetEniDetailRequest request) {
2 }
            参数含义
请参考OpenAPI文档 查询指定Eni请求参数
返回值
- 操作成功
 
1{
2    "metadata":"metadata格式参考附录metadata部分",
3    "eniId": "eni-gu14mqxy6vz1",
4    "name": "a1",
5    "vpcId": "vpc-5zmchpfuc03w",
6    "subnetId": "sbn-tzgpvbmuk69d",
7    "zoneName": "cn-bj-a",
8    "description": "aa1",
9    "createdTime": "2022-04-06T08:04:31Z",
10    "macAddress": "fa:f6:00:0f:93:25",
11    "status": "available",
12    "networkInterfaceTrafficMode": "standard",
13    "privateIpSet": [
14        {
15            "primary": true,
16            "privateIpAddress": "192.168.0.7"
17        }
18    ],
19    "ipv6PrivateIpSet": [],
20    "securityGroupIds": [
21        "g-j2kg6vmvn7zm"
22    ],
23    "enterpriseSecurityGroupIds": []
24}
            - 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniDetail.java
弹性网卡挂载云主机
函数声明
1public void attachEniInstance(EniInstanceOperateRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni挂载云主机请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniAttachVm.java
弹性网卡卸载云主机
函数声明
1public void detachEniInstance(EniInstanceOperateRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni挂载云主机请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniDetachVm.java
弹性网卡绑定EIP
函数声明
1public void bindEniPublicIp(EniBindEipRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni绑定EIP请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniBindEip.java
弹性网卡解绑EIP
函数声明
1public void unBindEniPublicIp(EniUnBindEipRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni解绑EIP请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniUnBindEip.java
弹性网卡更新普通安全组
函数声明
1public void updateEniSecurityGroup(EniUpdateSecurityGroupRequest request) {
2 }
            参数说明
请参考OpenAPI文档 Eni更新普通安全组请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniUpdateSecurityGroups.java
弹性网卡更新企业安全组
函数声明
1 public void updateEniEnterpriseSecurityGroup(EniUpdateEnterpriseSecurityGroupRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni更新企业安全组请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniUpdateEnterpriseSecurityGroups.java
批量删除弹性网卡内网IP
函数声明
1public void batchDeletePrivateIp(EniPrivateIpBatchOperateRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni批量删除IP请求参数
返回值
- 操作成功
 
无返回值
- 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniBatchDelPrivateIp.java
批量增加弹性网卡内网IP
函数声明
1public void batchAddPrivateIp(EniPrivateIpBatchAddRequest request) {
2 }
            参数含义
请参考OpenAPI文档 Eni批量添加IP请求参数
返回值
- 操作成功
 
1{
2    "metadata":"metadata格式参考附录metadata部分",
3    "eniId":"eni-58djsuahfkj"
4}
            - 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniBatchAddPrivateIp.java
查询弹性网卡状态
函数声明
1 public EniStatusResponse getEniStatus(String eniId) {
2 }
            参数含义
请参考OpenAPI文档 查询Eni状态请求参数
返回值
- 操作成功
 
1{
2    "metadata":"metadata格式参考附录metadata部分",
3    "eniStatus":"inuse"
4}
            - 操作失败
 
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleGetEniStatus.java
附录
公共返回信息metadata格式
1 {
2      "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
3      "contentLength":28,
4      "contentType":"application/json;charset=UTF-8",
5      "date":1701917695000,
6      "server":"openresty/1.15.8.1"
7 }
            