更新时间:2026-08-14 GMT+08:00
获取桶归档存储对象直读策略
功能介绍
用户可通过本章节指导获取桶的归档存储对象直读策略。
接口约束
- 您必须是桶拥有者或拥有获取桶归档存储对象直读策略的权限,才能获取桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetDirectColdAccessConfiguration权限,如果使用桶策略则需授予GetDirectColdAccessConfiguration权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策略。
- OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。
方法定义
obsClient.getBucketDirectColdAccess(BaseBucketRequest request)
请求参数说明
| 参数名称 | 参数类型 | 是否必选 | 描述 |
|---|---|---|---|
| request | 必选 | 参数解释: 获取桶的归档存储对象直读策略请求参数,详见BaseBucketRequest。 |
返回结果说明
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| status | RuleStatusEnum | 参数解释: 标识桶的归档存储对象直读状态。如果从未设置桶的归档存储对象直读状态,或者已经删除桶的归档存储对象直读状态,则不会返回桶的归档存储对象直读状态。 取值范围: |
代码示例
本示例用于获取桶归档存储对象直读策略。
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.BaseBucketRequest;
import com.obs.services.model.DirectColdAccessEnum;
// 注意:网络操作必须在子线程中执行,否则会抛出NetworkOnMainThreadException
new Thread(() -> {
// 安全提示:硬编码AK/SK存在安全风险,建议从安全凭证管理系统获取
String ak = System.getenv("ACCESS_KEY_ID");
String sk = System.getenv("SECRET_ACCESS_KEY");
String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
ObsClient obsClient = null;
try {
obsClient = new ObsClient(ak, sk, endPoint);
String bucketName = "examplebucket";
// 获取桶归档直读策略
BucketDirectColdAccess result = obsClient.getBucketDirectColdAccess(bucketName);
Log.i("ObsDemo", "获取桶归档直读策略成功,直读策略: " + result.getDirectColdAccess());
} 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(); 父主题: 归档直读