Add a tag-set through an access point for a general purpose bucket - 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 (PDF).

Add a tag-set through an access point for a general purpose bucket

This section explains how to add a tag-set through an access point for a general purpose bucket using the Amazon Web Services Management Console, Amazon Command Line Interface, or REST API. For more information, see Categorizing your storage using tags.

To add a tag-set through an access point in your Amazon Web Services account

  1. Sign in to the Amazon Web Services Management Console and open the Amazon S3 console at https://console.amazonaws.cn/s3/.

  2. In the navigation bar on the top of the page, choose the name of the currently displayed Amazon Web Services Region. Next, choose the Region that you want to list access points for.

  3. In the navigation pane on the left side of the console, choose Access Points.

  4. (Optional) Search for access points by name. Only access points in your selected Amazon Web Services Region will appear here.

  5. Choose the name of the access point you want to manage or use.

  6. Under the Objects tab, select the name of the object you wish to add a tag-set to.

  7. Under the Properties tab, find the Tags sub-header and choose Edit.

  8. Review the objects listed, and choose Add tag.

  9. Each object tag is a key-value pair. Enter a Key and a Value. To add another tag, choose Add Tag.

    You can enter up to 10 tags for an object.

  10. Choose Save changes.

The following put-object-tagging example command shows how you can use the Amazon CLI to add a tag-set through an access point.

The following command adds a tag-set for existing object puppy.jpg using access point my-access-point.

aws s3api put-object-tagging --bucket arn:aws-cn:s3:Amazon Web Services Region:111122223333:accesspoint/my-access-point --key puppy.jpg --tagging TagSet=[{Key="animal",Value="true"}]
Note

S3 automatically generate access point aliases for all access points and access point aliases can be used anywhere a bucket name is used to perform object-level operations. For more information, see Access point for general purpose buckets aliases.

For more information and examples, see put-object-tagging in the Amazon CLI Command Reference.

You can use the REST API to add a tag-set to an object through an access point. For more information, see PutObjectTagging in the Amazon Simple Storage Service API Reference.