ListStorageLensConfigurations
Note
This operation is not supported by directory buckets.
Gets a list of Amazon S3 Storage Lens configurations. 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.
Note
To use this action, you must have permission to perform the
s3:ListStorageLensConfigurations
action. For more information, see
Setting permissions to
use Amazon S3 Storage Lens in the Amazon S3 User Guide.
Request Syntax
GET /v20180820/storagelens?nextToken=NextToken
HTTP/1.1
Host: s3-control.amazonaws.com.cn
x-amz-account-id: AccountId
URI Request Parameters
The request uses the following URI parameters.
- nextToken
-
A pagination token to request the next page of results.
- x-amz-account-id
-
The account ID of the requester.
Length Constraints: Maximum length of 64.
Pattern:
^\d{12}$
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListStorageLensConfigurationsResult>
<NextToken>string</NextToken>
<StorageLensConfiguration>
<HomeRegion>string</HomeRegion>
<Id>string</Id>
<IsEnabled>boolean</IsEnabled>
<StorageLensArn>string</StorageLensArn>
</StorageLensConfiguration>
...
</ListStorageLensConfigurationsResult>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- ListStorageLensConfigurationsResult
-
Root level tag for the ListStorageLensConfigurationsResult parameters.
Required: Yes
- NextToken
-
If the request produced more than the maximum number of S3 Storage Lens configuration results, you can pass this value into a subsequent request to retrieve the next page of results.
Type: String
- StorageLensConfiguration
-
A list of S3 Storage Lens configurations.
Type: Array of ListStorageLensConfigurationEntry data types
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: