配置对象级WORM保护策略(Node.js SDK)

功能介绍

开启了WORM开关的桶，上传的对象支持配置或修改对象保护期限。

• 如果上传对象时没有配置保护期限或自动应用桶级默认保护策略，您可以通过该操作配置对象保护期限。
• 如果上传对象时配置了保护期限或自动应用了默认保护期限，允许用户通过该操作延长保护期限。
• 对象保护期限仅允许修改，不允许删除。

接口约束

• 您必须是桶拥有者或拥有配置对象级WORM保护策略的权限，才能调用本接口。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObjectRetention权限，如果使用桶策略则需授予PutObjectRetention权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。
• OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

方法定义

ObsClient.setObjectRetention(params)

请求参数说明

返回结果

代码示例

您可以通过ObsClient.setObjectRetention配置对象级WORM保护策略。代码示例如下：

// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');

// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS，同样建议您尽量避免使用硬编码，以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK，也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以华北-北京四为例，其他地区请按实际情况填写
  server: "https://obs.cn-north-4.myhuaweicloud.com",
});

async function setObjectRetention() {
  try {
    // 计算保留到期时间：当前时间 + 30天（毫秒时间戳）
    const retainUntilDate = Date.now() + 30 * 24 * 60 * 60 * 1000;
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定对象名
      Key: "objectname.txt",
      // 指定保留模式
      Mode: "COMPLIANCE",
      // 指定保留到期时间
      RetainUntilDate: retainUntilDate,
    };
    // 配置对象级WORM保护策略
    const result = await obsClient.setObjectRetention(params);
    if (result.CommonMsg.Status <= 300) {
      console.log("Set object retention successful!\n");
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      return;
    };
    console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
    console.log("Status: %d", result.CommonMsg.Status);
    console.log("Code: %s", result.CommonMsg.Code);
    console.log("Message: %s", result.CommonMsg.Message);
    console.log("RequestId: %s", result.CommonMsg.RequestId);
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

setObjectRetention();