Creating an S3 on Outposts access point - Amazon S3 on Outposts

Creating an S3 on Outposts access point

To access your Amazon S3 on Outposts bucket, you must create and configure an access point.

Access points simplify managing data access at scale for shared datasets in Amazon S3. Access points are named network endpoints that are attached to buckets that you can use to perform Amazon S3 object operations, such as GetObject and PutObject. With S3 on Outposts, you must use access points to access any object in an Outposts bucket. Access points support only virtual-host-style addressing.

The following examples show you how to create an S3 on Outposts access point by using the AWS Management Console, AWS Command Line Interface (AWS CLI), and AWS SDK for Java.

Note

The AWS account that creates the Outposts bucket owns it and is the only one that can assign access points to it.

  1. Open the Amazon S3 console at https://console.aws.amazon.com/s3/.

  2. In the left navigation pane, choose Outposts buckets.

  3. Choose the Outposts bucket that you want to create an Outposts access point for.

  4. Choose the Outposts access points tab.

  5. In the Outposts access points section, choose Create Outposts access point.

  6. In Outposts access point settings, enter a name for the access point, and then choose the virtual private cloud (VPC) for the access point.

  7. If you want to add a policy for your access point, enter it in the Outposts access point policy section.

    For more information, see Setting up IAM with S3 on Outposts.

The following AWS CLI example creates an access point for an Outposts bucket. To run this command, replace the user input placeholders with your own information.

aws s3control create-access-point --account-id 123456789012 --name example-outposts-access-point --bucket "arn:aws:s3-outposts:region:123456789012:outpost/op-01ac5d28a6a232904/bucket/example-outposts-bucket" --vpc-configuration VpcId=example-vpc-12345

For examples of how to create an access point for an S3 Outposts bucket with the AWS SDK for Java, see CreateOutpostsAccessPoint.java in the AWS SDK for Java 2.x Code Examples.