Skip to content
This repository has been archived by the owner on Jun 28, 2023. It is now read-only.

Commit

Permalink
Periodic update - 2021-05-13
Browse files Browse the repository at this point in the history
  • Loading branch information
aws-alan committed May 13, 2021
1 parent c824a32 commit 0d17598
Show file tree
Hide file tree
Showing 58 changed files with 950 additions and 564 deletions.
2 changes: 1 addition & 1 deletion doc_source/PresignedUrlUploadObject.md
Expand Up @@ -189,7 +189,7 @@ import boto3
ExpiresIn=3600)
```

For a complete example that shows how to generate presigned URLs and how to use the Requests package to upload and download objects, see the [ PHP presigned URL](https://docs.aws.amazon.com/code-samples/latest/catalog/python-s3-s3_basics-presigned_url.py.html) example on GitHub\. For more information about using SDK for Python \(Boto3\) to generate a presigned URL, see [Python](http://amazonaws.com/http://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html#S3.Client.generate_presigned_url) in the *AWS SDK for PHP API Reference*\.
For a complete example that shows how to generate presigned URLs and how to use the Requests package to upload and download objects, see the [ Python presigned URL](https://docs.aws.amazon.com/code-samples/latest/catalog/python-s3-s3_basics-presigned_url.py.html) example on GitHub\. For more information about using SDK for Python \(Boto3\) to generate a presigned URL, see [Python](http://amazonaws.com/http://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html#S3.Client.generate_presigned_url) in the *AWS SDK for Python \(Boto\) API Reference*\.

------
#### [ Ruby ]
Expand Down
42 changes: 21 additions & 21 deletions doc_source/S3LensCLIExamples.md
@@ -1,21 +1,21 @@
# Amazon S3 Storage Lens examples using the AWS CLI<a name="S3LensCLIExamples"></a>

Amazon S3 Storage Lens aggregates your usage and activity metrics and displays the information in an interactive dashboard on the Amazon S3 console or through a metrics data export that can be downloaded in CSV or Parquet format\. You can use the dashboard to visualize insights and trends, flag outliers, and provides recommendations for optimizing storage costs and applying data protection best practices\. You can use S3 Storage Lens through the AWS Management Console, AWS CLI, AWS SDKs, or REST API\.\. For more information, see [Assessing storage activity and usage with Amazon S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html)\.
Amazon S3 Storage Lens aggregates your usage and activity metrics and displays the information in the account snapshot on the Amazon S3 console home \(**Buckets**\) page, interactive dashboards, or through a metrics export that you can download in CSV or Parquet format\. You can use the dashboard to visualize insights and trends, flag outliers, and receive recommendations for optimizing storage costs and applying data protection best practices\. You can use S3 Storage Lens through the AWS Management Console, AWS CLI, AWS SDKs, or REST API\.\. For more information, see [Assessing storage activity and usage with Amazon S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html)\.

The following examples show how you can use S3 Storage Lens with the AWS Command Line Interface\.

**Topics**
+ [Helper files for using Amazon S3 Storage Lens](#S3LensHelperFilesCLI)
+ [Using Amazon S3 Storage Lens configurations using the AWS CLI](#S3LensConfigurationsCLI)
+ [Using Amazon S3 Storage Lens with your AWS Organizations using the AWS CLI](#S3LensOrganizationsCLI)
+ [Using Amazon S3 Storage Lens configurations with the AWS CLI](#S3LensConfigurationsCLI)
+ [Using Amazon S3 Storage Lens with AWS Organizations using the AWS CLI](#S3LensOrganizationsCLI)

## Helper files for using Amazon S3 Storage Lens<a name="S3LensHelperFilesCLI"></a>

Use the following json files for key inputs for your examples\.
Use the following JSON files for key inputs for your examples\.



### S3 Storage Lens sample configuration json<a name="S3LensHelperFilesSampleConfigurationCLI"></a>
### S3 Storage Lens sample configuration JSON<a name="S3LensHelperFilesSampleConfigurationCLI"></a>

**Example config\.json**
Contains details of a S3 Storage Lens Organizations\-level *Advanced Metrics and Recommendations* configuration\.
Expand Down Expand Up @@ -71,7 +71,7 @@ Additional charges apply for Advanced Metrics and Recommendations\. For more inf
}
```

### S3 Storage Lens sample configuration tags json<a name="S3LensHelperFilesSampleConfigurationTagsCLI"></a>
### S3 Storage Lens sample configuration tags JSON<a name="S3LensHelperFilesSampleConfigurationTagsCLI"></a>

**Example tags\.json**

Expand Down Expand Up @@ -123,16 +123,16 @@ S3 Storage Lens IAM permissions\.
}
```

## Using Amazon S3 Storage Lens configurations using the AWS CLI<a name="S3LensConfigurationsCLI"></a>
## Using Amazon S3 Storage Lens configurations with the AWS CLI<a name="S3LensConfigurationsCLI"></a>

You can use the AWS CLI to list, create, get and update your S3 Storage Lens configurations\. The following examples use the helper json files for key inputs\.
You can use the AWS CLI to list, create, get and update your S3 Storage Lens configurations\. The following examples use the helper JSON files for key inputs\.

**Topics**
+ [Put an S3 Storage Lens configuration](#S3PutStorageLensConfigurationTagsCLI)
+ [Put an S3 Storage Lens configuration without tags](#S3PutStorageLensConfigurationWOTagsCLI)
+ [Gets an S3 Storage Lens configuration](#S3GetStorageLensConfigurationCLI)
+ [Lists S3 Storage Lens configurations without next token](#S3ListStorageLensConfigurationsWOTokenCLI)
+ [Lists S3 Storage Lens configurations](#S3ListStorageLensConfigurationsCLI)
+ [Get an S3 Storage Lens configuration](#S3GetStorageLensConfigurationCLI)
+ [List S3 Storage Lens configurations without next token](#S3ListStorageLensConfigurationsWOTokenCLI)
+ [List S3 Storage Lens configurations](#S3ListStorageLensConfigurationsCLI)
+ [Delete an S3 Storage Lens configuration](#S3DeleteStorageLensConfigurationCLI)
+ [Put tags to an S3 Storage Lens configuration](#S3PutStorageLensConfigurationTaggingCLI)
+ [Get tags for an S3 Storage Lens configuration](#S3GetStorageLensConfigurationTaggingCLI)
Expand All @@ -148,31 +148,31 @@ aws s3control put-storage-lens-configuration --account-id=222222222222 --config-

### Put an S3 Storage Lens configuration without tags<a name="S3PutStorageLensConfigurationWOTagsCLI"></a>

**Example Puts an S3 Storage Lens configuration\.**
**Example Put an S3 Storage Lens configuration**

```
aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
```

### Gets an S3 Storage Lens configuration<a name="S3GetStorageLensConfigurationCLI"></a>
### Get an S3 Storage Lens configuration<a name="S3GetStorageLensConfigurationCLI"></a>

**Example Get an S3 Storage Lens configuration**

```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

### Lists S3 Storage Lens configurations without next token<a name="S3ListStorageLensConfigurationsWOTokenCLI"></a>
### List S3 Storage Lens configurations without next token<a name="S3ListStorageLensConfigurationsWOTokenCLI"></a>

**Example Lists S3 Storage Lens configurations without next token**
**Example List S3 Storage Lens configurations without next token**

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```

### Lists S3 Storage Lens configurations<a name="S3ListStorageLensConfigurationsCLI"></a>
### List S3 Storage Lens configurations<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example Lists S3 Storage Lens configurations**
**Example List S3 Storage Lens configurations**

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
Expand Down Expand Up @@ -210,15 +210,15 @@ aws s3control get-storage-lens-configuration-tagging --account-id=222222222222 -
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```

## Using Amazon S3 Storage Lens with your AWS Organizations using the AWS CLI<a name="S3LensOrganizationsCLI"></a>
## Using Amazon S3 Storage Lens with AWS Organizations using the AWS CLI<a name="S3LensOrganizationsCLI"></a>

Use Amazon S3 Storage Lens to collect storage metrics and usage data for all accounts that are part of your AWS Organizations hierarchy\. For more information, see [Using Amazon S3 Storage Lens with AWS Organizations](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_with_organizations.html)\.

**Topics**
+ [Enable Organizations trusted access for S3 Storage Lens](#OrganizationsEnableTrustedAccessS3LensCLI)
+ [Disable Organizations trusted access for S3 Storage Lens](#OrganizationsDisableTrustedAccessS3LensCLI)
+ [Register Organizations delegated administrators for S3 Storage Lens](#OrganizationsRegisterDelegatedAdministratorS3LensCLI)
+ [De\-register Organizations delegated administrators for S3 Storage Lens](#OrganizationsDeregisterDelegatedAdministratorS3LensCLI)
+ [Deregister Organizations delegated administrators for S3 Storage Lens](#OrganizationsDeregisterDelegatedAdministratorS3LensCLI)



Expand Down Expand Up @@ -246,9 +246,9 @@ aws organizations disable-aws-service-access --service-principal storage-lens.s3
aws organizations register-delegated-administrator --service-principal storage-lens.s3.amazonaws.com —account-id 123456789012
```

### De\-register Organizations delegated administrators for S3 Storage Lens<a name="OrganizationsDeregisterDelegatedAdministratorS3LensCLI"></a>
### Deregister Organizations delegated administrators for S3 Storage Lens<a name="OrganizationsDeregisterDelegatedAdministratorS3LensCLI"></a>

**Example De\-register Organizations delegated administrators for S3 Storage Lens**
**Example Deregister Organizations delegated administrators for S3 Storage Lens**

```
aws organizations deregister-delegated-administrator --service-principal storage-lens.s3.amazonaws.com —account-id 123456789012
Expand Down
10 changes: 6 additions & 4 deletions doc_source/S3LensExamples.md
@@ -1,12 +1,14 @@
# Amazon S3 Storage Lens examples and console walk\-through<a name="S3LensExamples"></a>
# Working with Amazon S3 Storage Lens using the console and API<a name="S3LensExamples"></a>

Amazon S3 Storage Lens aggregates your usage and activity metrics and displays the information in an interactive dashboard on the Amazon S3 console or through a metrics data export that can be downloaded in CSV or Parquet format\. You can use the dashboard to visualize insights and trends, flag outliers, and provides recommendations for optimizing storage costs and applying data protection best practices\. You can use S3 Storage Lens through the AWS Management Console, AWS CLI, AWS SDKs, or REST API\.
Amazon S3 Storage Lens aggregates your usage and activity metrics and displays the information in the account snapshot on the Amazon S3 console home \(**Buckets**\) page, interactive dashboards, or through a metrics export that you can download in CSV or Parquet format\. You can use the dashboard to visualize insights and trends, flag outliers, and receive recommendations for optimizing storage costs and applying data protection best practices\. You can use S3 Storage Lens through the AWS Management Console, AWS CLI, AWS SDKs, or REST API\.

The following video shows a brief demonstration of how to use S3 Storage Lens on the Amazon S3 console\.

[![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/TNmZEvwFiOA/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/TNmZEvwFiOA)

This section contains examples of creating, updating, and viewing S3 Storage Lens configurations and performing operations related to the feature\. If you are using S3 Storage Lens with AWS Organizations, these examples also cover those use cases\. In the examples, replace any variable values with those that are specific to you\.
The following sections contain examples of creating, updating, and viewing S3 Storage Lens configurations and performing operations related to the feature\. If you are using S3 Storage Lens with AWS Organizations, these examples also cover those use cases\. In the examples, replace any variable values with those that are specific to you\.

**Topics**
+ [Using Amazon S3 Storage Lens in the console](storage_lens_console.md)
+ [Using Amazon S3 Storage Lens on the console](storage_lens_console.md)
+ [Amazon S3 Storage Lens examples using the AWS CLI](S3LensCLIExamples.md)
+ [Amazon S3 Storage Lens examples using the SDK for Java](S3LensJavaExamples.md)
2 changes: 1 addition & 1 deletion doc_source/S3LensJavaExamples.md
@@ -1,6 +1,6 @@
# Amazon S3 Storage Lens examples using the SDK for Java<a name="S3LensJavaExamples"></a>

Amazon S3 Storage Lens aggregates your usage and activity metrics and displays the information in an interactive dashboard on the Amazon S3 console or through a metrics data export that can be downloaded in CSV or Parquet format\. You can use the dashboard to visualize insights and trends, flag outliers, and provides recommendations for optimizing storage costs and applying data protection best practices\. You can use S3 Storage Lens through the AWS Management Console, AWS CLI, AWS SDKs, or REST API\.\. For more information, see [Assessing storage activity and usage with Amazon S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html)\.
Amazon S3 Storage Lens aggregates your usage and activity metrics and displays the information in the account snapshot on the Amazon S3 console home \(**Buckets**\) page, interactive dashboards, or through a metrics export that you can download in CSV or Parquet format\. You can use the dashboard to visualize insights and trends, flag outliers, and receive recommendations for optimizing storage costs and applying data protection best practices\. You can use S3 Storage Lens through the AWS Management Console, AWS CLI, AWS SDKs, or REST API\.\. For more information, see [Assessing storage activity and usage with Amazon S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html)\.

The following examples show how you can use S3 Storage Lens with the AWS SDK for Java\.

Expand Down
29 changes: 15 additions & 14 deletions doc_source/S3OnOutpostsRestrictionsLimitations.md
Expand Up @@ -9,11 +9,11 @@ Consider the following restrictions and limitations as you set up Amazon S3 on O
+ [Unsupported Amazon S3 features](#S3OnOutpostsFeatureLimitations)
+ [Network restrictions](#S3OnOutpostsConnectivityRestrictions)

## Amazon S3 on Outposts specifications<a name="S3OnOutpostsSpecifications"></a>
+ Maximum Outposts bucket size is 50 TB\.
+ Maximum number of Outposts buckets per Outpost is 100\.
## S3 on Outposts specifications<a name="S3OnOutpostsSpecifications"></a>
+ The maximum Outposts bucket size is 50 TB\.
+ The maximum number of Outposts buckets per Outpost is 100\.
+ Outposts buckets can only be accessed using access points and endpoints\.
+ Maximum number of access points per Outposts bucket is 10\.
+ The maximum number of access points per Outposts bucket is 10\.
+ Access point policies are limited to 20 KB in size\.
+ The S3 on Outposts bucket owner account is always the owner of all objects in the bucket\.
+ Only the S3 on Outposts bucket owner account can perform operations on the bucket\.
Expand All @@ -22,7 +22,7 @@ Consider the following restrictions and limitations as you set up Amazon S3 on O
+ All objects stored in the `OUTPOSTS` storage class are stored using server\-side encryption with Amazon S3 managed encryption keys \(SSE\-S3\) by default\. You can also explicitly choose to store objects using server\-side encryption with customer\-provided encryption keys \(SSE\-C\)\.
+ If there is not enough space to store an object on your Outpost, the API will return an insufficient capacity exception \(ICE\)\.

## Amazon S3 on Outposts data consistency model<a name="S3OnOutpostsDataConsistency"></a>
## S3 on Outposts data consistency model<a name="S3OnOutpostsDataConsistency"></a>

Amazon S3 on Outposts provides read\-after\-write consistency for PUTS of new objects in your Amazon S3 bucket with one caveat: If you make a HEAD or GET request to a key name before the object is created and then create the object shortly after that, a subsequent GET might not return the object due to eventual consistency\.

Expand All @@ -34,7 +34,7 @@ Updates to a single key are atomic\. For example, if you PUT to an existing key,
+ A process deletes an existing object and immediately tries to read it\. Until the deletion is fully propagated, S3 on Outposts might return the deleted data\.
+ A process deletes an existing object and immediately lists keys within its bucket\. Until the deletion is fully propagated, S3 on Outposts might list the deleted object\.

## API operations supported by Amazon S3 on Outposts<a name="S3OnOutpostsAPILimitations"></a>
## API operations supported by S3 on Outposts<a name="S3OnOutpostsAPILimitations"></a>

Amazon S3 on Outposts is designed to use the same object APIs as Amazon S3\. Therefore, you can use many of your existing code and policies by passing the S3 on Outposts Amazon Resource Name \(ARN\) as your identifier\.

Expand All @@ -59,7 +59,7 @@ Amazon S3 on Outposts supports the following API operations:
+ `UploadPart`
+ `UploadPartCopy`

## Amazon S3 features not supported by Amazon S3 on Outposts<a name="S3OnOutpostsFeatureLimitations"></a>
## Amazon S3 features not supported by S3 on Outposts<a name="S3OnOutpostsFeatureLimitations"></a>

Several Amazon S3 features are currently not supported by Amazon S3 on Outposts\. Any attempts to use them are rejected\.
+ Access control list \(ACL\)
Expand All @@ -79,7 +79,7 @@ Several Amazon S3 features are currently not supported by Amazon S3 on Outposts\
+ Amazon CloudWatch request metrics
+ Metrics configuration
+ Transfer acceleration
+ Event notifications
+ Event Notifications
+ Requester Pays buckets
+ S3 Select
+ Torrent
Expand All @@ -90,16 +90,17 @@ Several Amazon S3 features are currently not supported by Amazon S3 on Outposts\
+ SOAP
+ Website access

## Amazon S3 on Outposts network restrictions<a name="S3OnOutpostsConnectivityRestrictions"></a>
+ You cannot create Amazon S3 on Outposts access point for virtual private clouds \(VPCs\) associated with more than one associated CIDR block\.
+ To route requests to an S3 on Outposts access point, you must create and configure an endpoint\. The following limits apply to endpoints for S3 on Outposts:
+ Each virtual private cloud \(VPC\) on your AWS Outposts can have one associated endpoint, and you can have up to three endpoints per Outpost\.
## S3 on Outposts network restrictions<a name="S3OnOutpostsConnectivityRestrictions"></a>
+ To route requests to an S3 on Outposts access point, you must create and configure an S3 on Outposts endpoint\. The following limits apply to endpoints for S3 on Outposts:
+ Each virtual private cloud \(VPC\) on your AWS Outposts can have one associated endpoint, and you can have up to 100 endpoints per Outpost\.
+ Multiple access points can be mapped to the same endpoint\.
+ Endpoints can only be added to VPCs with CIDR blocks in the subspaces of the following CIDR ranges:
+ 10\.0\.0\.0/8
+ 172\.16\.0\.0/12
+ 192\.168\.0\.0/16
+ An endpoint can only be created within a single CIDR block\.
+ Endpoints to an Outpost can only be created from VPCs that have non\-overlapping CIDR blocks\.
+ You can only create an endpoint for VPCs associated with only one CIDR block\.
+ An endpoint can only be created from within its Outposts subnet\.
+ Connections from peered VPCs to an endpoint are not supported\.
+ The subnet used to create an endpoint must contain four IP addresses for S3 on Outposts to use\.
+ A CIDR range used to create an endpoint for an Outpost cannot be reused for another endpoint within that VPC\.
+ You can only create one endpoint per outpost per VPC\.

0 comments on commit 0d17598

Please sign in to comment.