# OBS客户端初始化
#### 功能说明
OBS客户端（ObsClient）是访问OBS服务的BrowserJS客户端，它为调用者提供一系列与OBS服务进行交互的接口，用于管理、操作桶（Bucket）和对象（Object）等OBS服务上的资源。
#### 方法定义
```
1.构造函数形式：ObsClient(parameter)
2.工厂方法形式：ObsClient.factory(parameter)
```
#### 参数描述
| **字段名**           | **类型**  | **约束** | **说明**                                                                                                                                                         |
|:---|:---|:---|:---|
| access_key_id     | String  | 可选     | 访问密钥中的AK，如何获取请参考[获取AK/SK](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)。                                                                      |
| secret_access_key | String  | 可选     | 访问密钥中的SK，如何获取请参考[获取AK/SK](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)。                                                                      |
| server            | String  | 必选     | 连接OBS的服务地址。可包含协议类型、域名、端口号。示例：https://your-endpoint:443。 您可以从[这里](https://developer.huaweicloud.com/endpoint?OBS)查看OBS当前开通的服务地址。 |
| timeout           | Number  | 可选     | HTTP/HTTPS请求的总超时时间（单位：秒）。默认为300秒。如网络状况不佳或者上传文件较大，建议增大timeout的值。                                                                                                |
| is_cname          | Boolean | 可选     | 是否通过自定义域名访问OBS服务。默认为false。                                                                                                                                     |
| useRawXhr         | Boolean | 可选     | 是否使用原生XHR发送Ajax请求。默认为false。                                                                                                                                    |
   
#### 代码样例
```
// 创建ObsClient实例
var obsClient = new ObsClient({
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
    // 前端本身没有process对象，可以使用webpack类打包工具定义环境变量，就可以在代码中运行了。
    // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    access_key_id: process.env.AccessKeyID,
    secret_access_key: process.env.SecretAccessKey,
    timeout : 300,
    // 这里以华北-北京四为例，其他地区请按实际情况填写
    server: 'https://obs.cn-north-4.myhuaweicloud.com'
});
```