Working with S3 on Outposts objects
With Amazon S3 on Outposts, you can create S3 buckets on your Amazon Outposts and easily store and
retrieve objects on premises for applications that require local data access, local data
processing, and data residency. S3 on Outposts provides a new storage class, S3 Outposts
(OUTPOSTS
), which uses the Amazon S3 APIs, and is designed to store
data durably and redundantly across multiple devices and servers on your Amazon Outposts. You communicate with your Outpost bucket
by using an access point
and endpoint connection over a virtual private cloud (VPC). You can use the same APIs and
features on Outpost buckets as you do on Amazon S3 buckets, including access policies, encryption, and tagging.
You can use S3 on Outposts through the Amazon Web Services Management Console, Amazon Command Line Interface (Amazon CLI), Amazon SDKs, or REST API.
Objects are the fundamental entities stored in Amazon S3 on Outposts. Every object is contained in a bucket. You must use access points to access any object in an Outpost bucket. When you specify the bucket for object operations, you use the access point Amazon Resource Name (ARN) or the access point alias. For more information about access point aliases, see Using a bucket-style alias for your S3 on Outposts bucket access point.
The following example shows the ARN format for S3 on Outposts access points, which includes the Amazon Web Services Region code for the Region that the Outpost is homed to, the Amazon Web Services account ID, the Outpost ID, and the access point name:
arn:aws-cn:s3-outposts:
region
:account-id
:outpost/outpost-id
/accesspoint/accesspoint-name
For more information about S3 on Outposts ARNs, see Resource ARNs for S3 on Outposts.
Object ARNs use the following format, which includes the Amazon Web Services Region that the Outpost is homed to, Amazon Web Services account ID, Outpost ID, bucket name, and object key:
arn:aws-cn:s3-outposts:
us-west-2
:123456789012
:outpost/op-01ac5d28a6a232904
/bucket/
amzn-s3-demo-bucket1
/object/myobject
With Amazon S3 on Outposts, object data is always stored on the Outpost. When Amazon installs an Outpost rack, your data stays local to your Outpost to meet data-residency requirements. Your objects never leave your Outpost and are not in an Amazon Web Services Region. Because the Amazon Web Services Management Console is hosted in-Region, you can't use the console to upload or manage objects in your Outpost. However, you can use the REST API, Amazon Command Line Interface (Amazon CLI), and Amazon SDKs to upload and manage your objects through your access points.
Topics
- Upload an object to an S3 on Outposts bucket
- Copying an object in an Amazon S3 on Outposts bucket using the Amazon SDK for Java
- Getting an object from an Amazon S3 on Outposts bucket
- Listing the objects in an Amazon S3 on Outposts bucket
- Deleting objects in Amazon S3 on Outposts buckets
- Using HeadBucket to determine if an S3 on Outposts bucket exists and you have access permissions
- Performing and managing a multipart upload with the SDK for Java
- Using presigned URLs for S3 on Outposts
- Amazon S3 on Outposts with local Amazon EMR on Outposts
- Authorization and authentication caching