PutStorageLensConfigurationTagging - 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).



This operation is not supported by directory buckets.

Put or replace tags on an existing Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see Assessing your storage activity and usage with Amazon S3 Storage Lens in the Amazon S3 User Guide.


To use this action, you must have permission to perform the s3:PutStorageLensConfigurationTagging action. For more information, see Setting permissions to use Amazon S3 Storage Lens in the Amazon S3 User Guide.

Request Syntax

PUT /v20180820/storagelens/storagelensid/tagging HTTP/1.1 Host: s3-control.amazonaws.com.cn x-amz-account-id: AccountId <?xml version="1.0" encoding="UTF-8"?> <PutStorageLensConfigurationTaggingRequest xmlns="http://awss3control.amazonaws.com/doc/2018-08-20/"> <Tags> <Tag> <Key>string</Key> <Value>string</Value> </Tag> </Tags> </PutStorageLensConfigurationTaggingRequest>

URI Request Parameters

The request uses the following URI parameters.


The ID of the S3 Storage Lens configuration.

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9\-\_\.]+

Required: Yes


The account ID of the requester.

Length Constraints: Maximum length of 64.

Pattern: ^\d{12}$

Required: Yes

Request Body

The request accepts the following data in XML format.


Root level tag for the PutStorageLensConfigurationTaggingRequest parameters.

Required: Yes


The tag set of the S3 Storage Lens configuration.


You can set up to a maximum of 50 tags.

Type: Array of StorageLensTag data types

Required: Yes

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: