快速使用
更新时间：2025-08-11
新建bec.Client
bec.Client是Bec服务的Go客户端，为开发者与BEC服务进行交互提供了一系列的方法。使用Go SDK发起BEC请求，您需要创建一个bec.Client实例。
通过AK/SK方式访问BEC，用户可以参考如下代码新建一个bec.Client：
Plain Text
1 // 用户的Access Key ID和Secret Access Key
2 ACCESS_KEY_ID, SECRET_ACCESS_KEY := "<your-access-key-id>", "<your-secret-access-key>"
3 // BEC服务的Endpoint
4 ENDPOINT := "<domain-name>"
5 // 创建BEC服务的Client
6 bosClient, err := bec.NewClient(AK, SK, ENDPOINT)在上面代码中，ACCESS_KEY_ID对应控制台中的“Access Key ID”，SECRET_ACCESS_KEY对应控制台中的“Access Key Secret”，获取方式请参考《操作指南 管理ACCESSKEY》。注意：ENDPOINT参数用于指定域名，BEC API的服务域名为bec.baidubce.com。
使用HTTPS协议
该SDK支持使用HTTPS协议访问百度云的服务产品。要使用HTTPS协议，只需在您创建对应服务的Client对象时指定的Endpoint中指明使用https协议的域名即可，SDK会自动识别并使用HTTPS协议访问。
错误处理
GO语言以error类型标识错误，定义了如下两种错误类型：
| 错误类型 | 说明 |
|---|---|
| BceClientError | 用户操作产生的错误 |
| BceServiceError | BOS服务返回的错误 |
用户使用SDK调用各服务的相关接口，除了返回所需的结果之外还会返回错误，用户可以获取相关错误的详细信息进行处理。
客户端异常表示客户端尝试向百度云服务发送请求以及数据传输时遇到的异常。例如，当发送请求时网络连接不可用时，则会返回BceClientError；当上传文件时发生IO异常时，也会抛出BceClientError。
当服务端出现异常时，百度云服务端会返回给用户相应的错误信息，以便定位问题。