ListObjects 是 AWS SDK for JavaScript 中用于列出 S3 存储桶内对象的核心方法之一,常用于管理文件存储。以下是详细说明:

🔍 基本功能

  • 列出存储桶内所有对象(支持分页)
  • 过滤对象(如按前缀、日期)
  • 获取对象元数据(如大小、最后修改时间)

✅ 使用步骤

  1. 初始化 S3 客户端

    const s3 = new AWS.S3({ region: 'your_region' });
    
  2. 调用 ListObjects 方法

    s3.listObjects({ Bucket: 'your_bucket_name' }, (err, data) => {
      if (err) console.error(err);
      console.log(data.Contents); // 对象列表
    });
    
  3. 处理分页(若对象数量超过 1000)
    使用 ContinuationToken 参数实现链式请求:

    const params = { Bucket: 'your_bucket_name' };
    let continuationToken = null;
    
    async function listAllObjects() {
      do {
        params.ContinuationToken = continuationToken;
        const result = await s3.listObjectsAsync(params);
        console.log(result.Contents);
        continuationToken = result.NextContinuationToken;
      } while (continuationToken);
    }
    

📌 注意事项

  • 默认每页返回 1000 个对象,超过需分页
  • 支持 Prefix 参数实现目录级别的列表
  • 可结合 Delimiter 参数分组对象(如按文件夹结构)

🌐 扩展阅读

点击了解更多 AWS SDK for JavaScript 的 S3 操作方法 📚

AWS_S3_ListObjects_Icon