Replace all object tags - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Replace all object tags

The Replace all object tags operation replaces the Amazon S3 object tags on every object listed in the manifest. An Amazon S3 object tag is a key-value pair of strings that you can use to store metadata about an object.

To create a Replace all object tags job, you provide a set of tags that you want to apply. S3 Batch Operations applies the same set of tags to every object. The tag set that you provide replaces whatever tag sets are already associated with the objects in the manifest. S3 Batch Operations does not support adding tags to objects while leaving the existing tags in place.

If the objects in your manifest are in a versioned bucket, you can apply the tag set to specific versions of every object. You do this by specifying a version ID for every object in the manifest. If you don't include a version ID for any object, then S3 Batch Operations applies the tag set to the latest version of every object.

Restrictions and limitations

  • The Amazon Identity and Access Management (IAM) role that you specify to run the Batch Operations job must have permissions to perform the underlying Amazon S3 Replace all object tags operation. For more information about the permissions required, see PutObjectTagging in the Amazon Simple Storage Service API Reference.

  • S3 Batch Operations uses the Amazon S3 PutObjectTagging operation to apply tags to each object in the manifest. All restrictions and limitations that apply to the underlying operation also apply to S3 Batch Operations jobs.

For more information about using the console to create jobs, see Creating an S3 batch operations job.

For more information about object tagging, see Categorizing your storage using tags in this guide, and see PutObjectTagging, GetObjectTagging, and DeleteObjectTagging in the Amazon Simple Storage Service API Reference.