存储类型转换

本SDK提供CopyObjectCommand类实现存储类型转换,允许在不移动或重新上传文件的情况下更新对象的元数据。完整代码详见 GithubCopyObjectCommand调用的 S3 API 为 CopyObject, 具体参见CopyObject API 文档

参数说明

  • Bucket: 文件所在的存储空间
  • CopySource: 存储空间内的文件路径
  • Key: 文件在存储空间内的名称
  • StorageClass: S3 存储类型
  • MetadataDirective: 复制原有元数据("COPY")或替换为新的元数据("REPLACE")

存储类型转换规则

US3存储类型 S3存储类型 US3对应S3默认存储类型
STANDARD STANDARD
STANDARD_IA
STANDARD
IA ONEZONE_IA
INTELLIGENT_TIERING
REDUCED_REDUNDANCY
ONEZONE_IA
ARCHIVE GLACIER
DEEP_ARCHIVE
GLACIER

示例

执行该示例前请确保配置文件的正确性
以下代码段需要在上下文中运行

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
const s3 = require('./s3Client');
const { CopyObjectCommand } = require("@aws-sdk/client-s3");
async function updateStorageClass(bucketName, keyName, storageClass) {
    try {
        const copySource = `${bucketName}/${keyName}`;
        const params = {
            Bucket: bucketName,
            CopySource: copySource,
            Key: keyName,
            StorageClass: storageClass,
            MetadataDirective: 'COPY'
        };
        const command = new CopyObjectCommand(params);
        const response = await s3.send(command);
        console.log("Storage class updated successfully", response);
        return response;
    } catch (err) {
        console.error("Error updating storage class", err);
        throw err;
    }
}

Example/ 目录中运行以下命令执行该示例

1
$ node PutObjectUpdate.js <bucketName> <keyName> <storageClass>