

# 替换所有对象标签
<a name="batch-ops-put-object-tagging"></a>

可以使用 Amazon S3 批量操作对 Amazon S3 对象执行大规模批量操作。**替换所有对象标签**操作将替换清单中列出的每个对象上的对象标签。 对象标签是一个字符串的键/值对，您可用它来存储有关对象的元数据。

要创建**替换所有对象标签**任务，您需要提供要应用的标签集。S3 分批操作将相同的标签集应用于每个对象。您提供的标签集替换已与清单中的对象关联的任何标签集。S3 批量操作不支持在保留现有标签的同时向对象添加标签。

如果清单中的对象位于受版本控制的存储桶中，您可将标签集应用到每个对象的特定版本。为此，请为清单中的每个对象指定版本 ID。如果您没有包括任何对象的版本 ID，则 S3 批量操作将标签集应用到每个对象的最新版本。有关分批操作清单的更多信息，请参阅 [指定清单](batch-ops-create-job.md#specify-batchjob-manifest)。

有关对象标记的更多信息，请参阅本指南中的[使用标签对对象进行分类](object-tagging.md)，并参阅《Amazon Simple Storage Service API 参考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html)、[https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html) 和 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html)。

要使用控制台创建**替换所有对象标签**任务，请参阅[创建 S3 批量操作任务](batch-ops-create-job.md)。

## 限制和局限性
<a name="batch-ops-set-tagging-restrictions"></a>

使用批量操作来替换对象标签时，以下限制和局限性适用：
+ 您指定用于运行批量操作任务的 AWS Identity and Access Management（IAM）角色必须有权执行基础 `PutObjectTagging` 操作。有关所需权限的更多信息，请参阅《Amazon Simple Storage Service API 参考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html)。
+ S3 批量操作使用 Amazon S3 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) 操作，来将标签应用到清单中的每个对象。适用于基础操作的所有限制也适用于 S3 分批操作任务。
+ 单个替换所有对象标签作业可以支持包含多达 200 亿个对象的清单。