# 设置桶归档存储对象直读策略 #### 功能介绍 归档存储对象直读是指用户可以不用恢复归档存储对象，便能直接对其进行操作。 默认情况下，桶没有开启归档存储对象直读功能。 本接口主要用来开启或关闭桶的归档存储对象直读功能。 - 设置桶的归档存储对象直读状态为Enabled，开启桶的归档存储对象直读功能： - 桶内存在归档存储对象时，不管该归档存储对象是否已经恢复，均可以直接操作该归档存储对象。 - 如果归档存储对象没有恢复，操作该归档存储对象时会增加单独计费。 - 设置桶的归档存储对象直读状态为Disabled，关闭桶的归档存储对象直读功能： - 归档存储对象无法直接操作，需要先恢复。 对象直读是指用户可以不用恢复归档存储对象，便能直接对其进行操作。了解更多归档存储数据直读相关信息，请参见[归档数据直读](https://support.huaweicloud.com/usermanual-obs/obs_03_0143.html)。 #### 接口约束 - 您必须是桶拥有者或者拥有设置桶归档存储对象直读策略的权限，才能调用本接口。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutDirectColdAccessConfiguration权限，如果使用桶策略则需授予PutDirectColdAccessConfiguration权限。相关授权方式介绍可参见[OBS权限控制概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)、[自定义创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html)。 - OBS支持的region以及region与endPoint的对应关系，详细信息请参见[地区与终端节点](https://developer.huaweicloud.com/endpoint?OBS)。 - 融合桶不支持归档存储对象直读。 #### 方法定义 obsClient.setBucketDirectColdAccess(SetBucketDirectColdAccessRequest request) #### 请求参数说明 表1请求参数列表 | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | request | [表2 SetBucketDirectColdAccessRequest] | 必选 | **参数解释：** 设置桶的归档存储对象直读策略，详见[表2 SetBucketDirectColdAccessRequest]。 | 表2SetBucketDirectColdAccessRequest | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | bucketName | String | 必选 | **参数解释** **：** 桶名。 **约束限制：** - 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。 - 桶命名规则如下： - 3～63个字符，数字或字母开头，支持小写字母、数字、"-"、"."。 - 禁止使用IP地址。 - 禁止以"-"或"."开头及结尾。 - 禁止两个"."相邻（如："my..bucket"）。 - 禁止"."和"-"相邻（如："my-.bucket"和"my.-bucket"）。 - 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。 **默认取值：** 无 | | access | BucketDirectColdAccess | 必选 | **参数解释：** 桶的归档存储对象直读策略配置。 **取值范围：** 详见[表3 BucketDirectColdAccess]。 **默认取值：** 无 | 表3BucketDirectColdAccess | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | status | RuleStatusEnum | 必选 | **参数解释：** 桶的归档存储对象直读状态。 **取值范围：** 详见[表4 RuleStatusEnum]。 **默认取值：** 无 | 表4RuleStatusEnum | **常量名** | **原始值** | **说明** | |:---|:---|:---| | ENABLED | Enabled | 开启桶归档存储对象直读策略。 | | DISABLED | Disabled | 不开启桶归档存储对象直读策略。 | #### 返回结果说明 表5返回结果HeaderResponse(SDK公共响应结果)各项属性说明 | **参数名称** | **参数类型** | **描述** | |:---|:---|:---| | statusCode | int | **参数解释：** HTTP状态码。 **取值范围：** 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。 完整的状态码列表请参见[状态码](https://support.huaweicloud.com/api-obs/obs_04_0114.html)。 **默认取值：** 无 | | responseHeaders | Map\ | **参数解释：** 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(); ```