弹性网卡
初始化
确认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进行配置,配置示例如下:
static final String HOST = "";
static final String AK = "";
static final String SK = "";
EniClientConfiguration config = new EniClientConfiguration();
config.setCredentials(new DefaultBceCredentials(AK, SK));
config.setEndpoint(HOST);
EniClien eniClient = new EniClien(config);
新建弹性网卡
函数声明
public CreateEniResponse createEni(CreateEniRequest request) {
}
参数含义
请参考OpenAPI文档 创建Eni请求参数
返回值
- 操作成功
{
"metadata":"metadata格式参考附录metadata部分",
"eniId":"eni-58djsuahfkj"
}
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleCreateEni.java
更新弹性网卡
函数声明
public void updateEni(EniUpdateRequest request) {
}
参数含义
请参考OpenAPI文档 更新Eni请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleUpdateEni.java
删除弹性网卡
函数声明
public void deleteEni(String eniId) {
}
参数含义
请参考OpenAPI文档 删除Eni请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleDeleteEni.java
查询弹性网卡列表
函数声明
public ListEniResponse listEni(ListEniRequest request) {
}
参数含义
请参考OpenAPI文档 List Eni请求参数
返回值
- 操作成功
{
"metadata":"metadata格式参考附录metadata部分",
"maxKeys": 1000,
"isTruncated": false,
"enis": [
{
"eniId": "eni-hkd58ti0vc6e",
"name": "testEni",
"vpcId": "vpc-b9ycwxxisrb7",
"subnetId": "sbn-6ha6gp1vczuv",
"zoneName": "cn-bj-a",
"description": "desc",
"createdTime": "2023-12-04T02:58:44Z",
"macAddress": "fa:f6:00:13:7f:ba",
"status": "available",
"networkInterfaceTrafficMode": "standard",
"privateIpSet": [
{
"primary": true,
"privateIpAddress": "192.168.0.8"
}
],
"ipv6PrivateIpSet": []
}
]
}
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleListEni.java
增加弹性网卡内网IP
函数声明
public void addPrivateIp(EniPrivateIpOperateRequest request) {
}
参数含义
请参考OpenAPI文档 创建Eni内网IP请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniAddPrivateIp.java
删除弹性网卡内网IP
函数声明
public void deletePrivateIp(EniPrivateIpOperateRequest request) {
}
参数含义
请参考OpenAPI文档 删除Eni内网IP请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniDelPrivateIp.java
查询指定的弹性网卡
函数声明
public EniDetail getEniDetail(GetEniDetailRequest request) {
}
参数含义
请参考OpenAPI文档 查询指定Eni请求参数
返回值
- 操作成功
{
"metadata":"metadata格式参考附录metadata部分",
"eniId": "eni-gu14mqxy6vz1",
"name": "a1",
"vpcId": "vpc-5zmchpfuc03w",
"subnetId": "sbn-tzgpvbmuk69d",
"zoneName": "cn-bj-a",
"description": "aa1",
"createdTime": "2022-04-06T08:04:31Z",
"macAddress": "fa:f6:00:0f:93:25",
"status": "available",
"networkInterfaceTrafficMode": "standard",
"privateIpSet": [
{
"primary": true,
"privateIpAddress": "192.168.0.7"
}
],
"ipv6PrivateIpSet": [],
"securityGroupIds": [
"g-j2kg6vmvn7zm"
],
"enterpriseSecurityGroupIds": []
}
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniDetail.java
弹性网卡挂载云主机
函数声明
public void attachEniInstance(EniInstanceOperateRequest request) {
}
参数含义
请参考OpenAPI文档 Eni挂载云主机请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniAttachVm.java
弹性网卡卸载云主机
函数声明
public void detachEniInstance(EniInstanceOperateRequest request) {
}
参数含义
请参考OpenAPI文档 Eni挂载云主机请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniDetachVm.java
弹性网卡绑定EIP
函数声明
public void bindEniPublicIp(EniBindEipRequest request) {
}
参数含义
请参考OpenAPI文档 Eni绑定EIP请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniBindEip.java
弹性网卡解绑EIP
函数声明
public void unBindEniPublicIp(EniUnBindEipRequest request) {
}
参数含义
请参考OpenAPI文档 Eni解绑EIP请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniUnBindEip.java
弹性网卡更新普通安全组
函数声明
public void updateEniSecurityGroup(EniUpdateSecurityGroupRequest request) {
}
参数说明
请参考OpenAPI文档 Eni更新普通安全组请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniUpdateSecurityGroups.java
弹性网卡更新企业安全组
函数声明
public void updateEniEnterpriseSecurityGroup(EniUpdateEnterpriseSecurityGroupRequest request) {
}
参数含义
请参考OpenAPI文档 Eni更新企业安全组请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniUpdateEnterpriseSecurityGroups.java
批量删除弹性网卡内网IP
函数声明
public void batchDeletePrivateIp(EniPrivateIpBatchOperateRequest request) {
}
参数含义
请参考OpenAPI文档 Eni批量删除IP请求参数
返回值
- 操作成功
无返回值
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniBatchDelPrivateIp.java
批量增加弹性网卡内网IP
函数声明
public void batchAddPrivateIp(EniPrivateIpBatchAddRequest request) {
}
参数含义
请参考OpenAPI文档 Eni批量添加IP请求参数
返回值
- 操作成功
{
"metadata":"metadata格式参考附录metadata部分",
"eniId":"eni-58djsuahfkj"
}
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleEniBatchAddPrivateIp.java
查询弹性网卡状态
函数声明
public EniStatusResponse getEniStatus(String eniId) {
}
参数含义
请参考OpenAPI文档 查询Eni状态请求参数
返回值
- 操作成功
{
"metadata":"metadata格式参考附录metadata部分",
"eniStatus":"inuse"
}
- 操作失败
操作失败返回异常列表参考Eni异常列表
代码示例
具体代码示例参考:ExampleGetEniStatus.java
附录
公共返回信息metadata格式
{
"bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
"contentLength":28,
"contentType":"application/json;charset=UTF-8",
"date":1701917695000,
"server":"openresty/1.15.8.1"
}