ListObjects 是 AWS SDK for JavaScript 中用于列出 S3 存储桶内对象的核心方法之一,常用于管理文件存储。以下是详细说明:
🔍 基本功能
- 列出存储桶内所有对象(支持分页)
- 过滤对象(如按前缀、日期)
- 获取对象元数据(如大小、最后修改时间)
✅ 使用步骤
初始化 S3 客户端
const s3 = new AWS.S3({ region: 'your_region' });
调用 ListObjects 方法
s3.listObjects({ Bucket: 'your_bucket_name' }, (err, data) => { if (err) console.error(err); console.log(data.Contents); // 对象列表 });
处理分页(若对象数量超过 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 操作方法 📚