更新时间:2026-08-14 GMT+08:00
设置桶归档存储对象直读策略
功能介绍
用户可通过本章节指导设置桶的归档存储对象直读策略。
接口约束
- 您必须是桶拥有者或拥有设置桶归档存储对象直读策略的权限,才能设置桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutDirectColdAccessConfiguration权限,如果使用桶策略则需授予PutDirectColdAccessConfiguration权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策略。
- OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。
方法定义
obsClient.setBucketDirectColdAccess(SetBucketDirectColdAccessRequest request)
请求参数说明
| 参数名称 | 参数类型 | 是否必选 | 描述 |
|---|---|---|---|
| request | 必选 | 参数解释: 设置桶的归档存储对象直读策略请求参数,详见表2 SetBucketDirectColdAccessRequest。 |
| 参数名称 | 参数类型 | 是否必选 | 描述 |
|---|---|---|---|
| bucketName | String | 必选 | 参数解释: 桶名。 约束限制:
默认取值: 无 |
| access | BucketDirectColdAccess | 必选 | 参数解释: 桶的跨区域复制配置。 取值范围: 默认取值: 无 |
返回结果说明
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| statusCode | int | 参数解释: HTTP状态码。 取值范围: 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。 完整的状态码列表请参见状态码。 默认取值: 无 |
| responseHeaders | Map<String, Object> | 参数解释: HTTP响应消息头列表,由多个元组构成。元组中String代表响应消息头的名称,Object代表响应消息头的值。 默认取值: 无 |
代码示例
本示例用于设置桶归档存储对象直读策略。
import android.util.Log;
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.BucketDirectColdAccess;
import com.obs.services.model.DirectColdAccessEnum;
import com.obs.services.model.HeaderResponse;
// 注意:网络操作必须在子线程中执行,否则会抛出NetworkOnMainThreadException
new Thread(() -> {
// 安全提示:硬编码AK/SK存在安全风险,建议从安全凭证管理系统获取
String ak = System.getenv("ACCESS_KEY_ID");
String sk = System.getenv("SECRET_ACCESS_KEY");
String endPoint = "https://your-endpoint";
ObsClient obsClient = null;
try {
obsClient = new ObsClient(ak, sk, endPoint);
String bucketName = "examplebucket";
// 设置桶归档直读策略为启用
BucketDirectColdAccess access = new BucketDirectColdAccess();
access.setDirectColdAccess(DirectColdAccessEnum.ENABLED);
HeaderResponse response = obsClient.setBucketDirectColdAccess(bucketName, access);
Log.i("ObsDemo", "设置桶归档直读策略成功,statusCode: " + response.getStatusCode());
} catch (ObsException e) {
Log.e("ObsDemo", "设置桶归档直读策略失败,HTTP状态码: " + e.getResponseCode()
+ ",错误码: " + e.getErrorCode()
+ ",错误信息: " + e.getErrorMessage());
} finally {
if (obsClient != null) {
try {
obsClient.close();
} catch (Exception e) {
Log.e("ObsDemo", "关闭ObsClient失败", e);
}
}
}
}).start(); 父主题: 归档直读