Creating an S3 on Outposts access point - Amazon S3 on Outposts
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).

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 Amazon Web Services Management Console, Amazon Command Line Interface (Amazon CLI), and Amazon SDK for Java.

Note

The Amazon Web Services 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.amazonaws.cn/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 Amazon 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-cn: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 Amazon SDK for Java, see CreateOutpostsAccessPoint.java in the Amazon SDK for Java 2.x Code Examples.