弹性网卡
初始化
确认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 }