BccClient

更新时间：2024-07-02

BccClient是BCC服务的客户端，为开发者与BCC服务进行交互提供了一系列的方法，包括实例、磁盘、镜像、快照、安全组、可用区等。

新建BccClient

通过AK/SK方式访问BCC

用户可以参考如下代码新建一个BccClient：

Plain Text

1public class Sample {
2public static void main(String[] args) {
3    String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
4    String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
5
6    // 初始化一个BccClient
7    BccClientConfiguration config = new BccClientConfiguration();
8    config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY));
9    BccClient client = new BccClient(config);
10    }
11}

在上面代码中，变量ACCESS_KEY_ID与SECRET_ACCESS_KEY是由系统分配给用户的，均为字符串，用于标识用户，为访问BCC做签名验证。其中ACCESS_KEY_ID对应控制台中的“Access Key ID”，SECRET_ACCESS_KEY对应控制台中的“Access Key Secret”，获取方式请参考《操作指南获取ACCESSKEY》。

上面的方式使用默认域名作为BCC的服务地址，如果用户需要自己指定域名，可以通过传入ENDPOINT参数来指定。

                Java
                
            

                String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
String ENDPOINT = <domain-name>;                               // 用户自己指定的域名

BccClientConfiguration config = new BccClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID,SECRET_ACCESS_KEY));
config.setEndpoint(ENDPOINT);
BccClient client = new BccClient(config);
            

注意： ENDPOINT参数只能用指定的包含区域的域名来进行定义，不指定时默认为北京区域http://bcc.bj.baidubce.com，百度智能云目前开放了多区域支持，更多请参考区域选择说明和服务域名。

配置HTTPS协议访问BCC

BCC支持HTTPS传输协议，您可以通过如下两种方式在BCC Java SDK中使用HTTPS访问BCC服务：

在endpoint中指明https:

                Java
                
            

                String endpoint = "http://bcc.bj.baidubce.com";
String ak = "ak";
String sk = "sk";
BccClientConfiguration config = new BccClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
BccClient client = new BccClient(config);
            

通过调用setProtocol方法设置https协议:

                Java
                
            

                String endpoint = "bcc.bj.baidubce.com"; // endpoint中不包含protocol
String ak = "ak";
String sk = "sk";
BccClientConfiguration config = new BccClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(ENDPOINT);
config.setProtocol(Protocol.HTTPS); // 如果不指明, 则使用http
BccClient client = new BccClient(config);
            

注意：如果在endpoint中指明了protocol, 则endpoint中的生效, 另外单独再调用setProtocol()不起作用。

                Java
                
            

                String endpoint = "http://bcc.bj.baidubce.com";
String ak = "ak";
String sk = "sk";
BccClientConfiguration config = new BccClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ak, sk));
config.setEndpoint(ENDPOINT);    
config.setProtocol(Protocol.HTTPS); // endpoint中已经指明, 此为无效操作, 对http也是如此
BccClient client = new BccClient(config);
            

配置BccClient

如果用户需要配置BccClient的一些细节的参数，可以在构造BccClient的时候传入BccClientConfiguration对象。 BccClientConfiguration是BCC服务的配置类，可以为客户端配置代理，最大连接数等参数。

使用代理

下面一段代码可以让客户端使用代理访问BCC服务：

                Java
                
            

                String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
String ENDPOINT = <domain-name>;                               // 用户自己指定的域名

// 创建BccClientConfiguration实例
BccClientConfiguration config = new BccClientConfiguration();

// 配置代理为本地8080端口
config.setProxyHost("127.0.0.1");
config.setProxyPort(8080);

// 创建BCC客户端
config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID,SECRET_ACCESS_KEY));
config.setEndpoint(ENDPOINT);
BccClient client = new BccClient(config);
            

使用上面的代码段，客户端的所有操作都会通过127.0.0.1地址的8080端口做代理执行。对于有用户验证的代理，可以通过下面的代码段配置用户名和密码：

                Java
                
            

                // 创建BccClientConfiguration实例
BccClientConfiguration config = new BccClientConfiguration();

// 配置代理为本地8080端口
config.setProxyHost("127.0.0.1");
config.setProxyPort(8080);

//设置用户名和密码
config.setProxyUsername(<username>);                             //用户名
config.setProxyPassword(<password>);                             //密码
            

设置网络参数

用户可以用BccClientConfiguration对基本网络参数进行设置：

                Java
                
                BccClientConfiguration config = new BccClientConfiguration();

// 设置HTTP最大连接数为10
config.setMaxConnections(10);

// 设置TCP连接超时为5000毫秒
config.setConnectionTimeout(5000);

// 设置Socket传输数据超时的时间为2000毫秒
config.setSocketTimeout(2000);

参数说明

通过BccClientConfiguration能指定的所有参数如下表所示：

参数	说明
UserAgent用户代理，指HTTP的User-Agent头
Protocol	连接协议类型
ProxyDomain	访问NTLM验证的代理服务器的Windows域名
ProxyHost	代理服务器主机地址
ProxyPort	代理服务器端口
ProxyUsername	代理服务器验证的用户名
ProxyPassword	代理服务器验证的密码
ProxyPreemptiveAuthenticationEnabled	是否设置用户代理认证
ProxyWorkstation	NTLM代理服务器的Windows工作站名称
LocalAddress	本地地址
ConnectionTimeoutInMillis	建立连接的超时时间（单位：毫秒）
SocketTimeoutInMillis	通过打开的连接传输数据的超时时间（单位：毫秒）
MaxConnections	允许打开的最大HTTP连接数
RetryPolicy	连接重试策略
SocketBufferSizeInBytes	Socket缓冲区大小
StreamBufferSize	流文件缓冲区大小

快速入门

BCC实例

百度智能云

云服务器 BCC