如何在指定S3存储桶中获取带有指定标签的对象？

S3并没有提供直接通过标签筛选对象的API，你需要分两步实现需求：

1. 列出存储桶内的所有对象 #

先用ListObjectsV2Command获取桶内的对象列表：

import { S3Client, ListObjectsV2Command, GetObjectTaggingCommand } from "@aws-sdk/client-s3";

const s3Client = new S3Client({ region: "你的区域标识" });

const listBucketObjects = async (bucketName) => {
  const command = new ListObjectsV2Command({ Bucket: bucketName });
  const response = await s3Client.send(command);
  return response.Contents || [];
};

2. 逐个校验对象标签并筛选 #

遍历对象列表，用GetObjectTaggingCommand获取每个对象的标签集合，匹配符合条件的对象：

const filterObjectsByTag = async (bucketName, tagKey, tagValue) => {
  const allObjects = await listBucketObjects(bucketName);
  const matchedObjects = [];

  for (const obj of allObjects) {
    const taggingCmd = new GetObjectTaggingCommand({
      Bucket: bucketName,
      Key: obj.Key
    });
    const taggingRes = await s3Client.send(taggingCmd);
    
    const hasTargetTag = taggingRes.TagSet.some(tag => 
      tag.Key === tagKey && tag.Value === tagValue
    );

    if (hasTargetTag) {
      matchedObjects.push(obj);
    }
  }

  return matchedObjects;
};

// 调用示例
filterObjectsByTag("你的存储桶名", "type", "archive")
  .then(result => console.log("匹配的对象:", result))
  .catch(err => console.error("执行出错:", err));

额外提示 #

• 如果桶内对象数量超过1000个，要处理ListObjectsV2Command的分页逻辑：检查返回结果的IsTruncated字段，若为true，则在下一次请求中传入ContinuationToken参数继续获取剩余对象。
• 频繁调用GetObjectTaggingCommand会产生API费用，若业务场景需要频繁按标签查询，建议将对象标签同步到数据库（如DynamoDB），通过数据库做快速筛选。

内容的提问来源于stack exchange，提问作者sunknudsen