Making requests using a Multi-Region Access Point
Multi-Region Access Points in Amazon S3 have Amazon Resource Names (ARNs), which you can use to direct requests to them using the AWS SDKs and to identify a Multi-Region Access Point in access control policies. A Multi-Region Access Point ARN doesn’t include or disclose its name. For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference.
Multi-Region Access Point ARNs use the format
arn:aws:s3::
.
The following are a few examples. <account-id>
:accesspoint/<MRAP_alias>
-
arn:aws:s3::123456789012:accesspoint/mfzwi23gnjvgw.mrap
represents the Multi-Region Access Point with the aliasmfzwi23gnjvgw.mrap
, owned by AWS account123456789012
. -
arn:aws:s3::123456789012:accesspoint/*
represents all Multi-Region Access Points under account123456789012
. This ARN matches all Multi-Region Access Points for account123456789012
, but doesn’t match any Regional access points because the ARN doesn’t include an AWS Region. In contrast, the ARNarn:aws:s3:us-west-2:123456789012:accesspoint/*
matches all Regional access points in Regionus-west-2
for account123456789012
, but doesn’t match any Multi-Region Access Points.
ARNs for objects that are accessed through a Multi-Region Access Point use the format
arn:aws:s3::
.
As with Multi-Region Access Point ARNs, the ARNs for objects that are accessed through Multi-Region Access Points don’t include an
AWS Region. Here are some examples. <account_id>
:accesspoint/<MRAP_alias>
/object/<key>
-
arn:aws:s3::123456789012:accesspoint/mfzwi23gnjvgw.mrap/object/unit-01
represents the objectunit-01
, accessed through the Multi-Region Access Point with the aliasmfzwi23gnjvgw.mrap
, owned by account123456789012
. -
arn:aws:s3::123456789012:accesspoint/mfzwi23gnjvgw.mrap/object/*
represents all objects that can be accessed through the Multi-Region Access Point with aliasmfzwi23gnjvgw.mrap
, in account123456789012
. -
arn:aws:s3::123456789012:accesspoint/mfzwi23gnjvgw.mrap/object/unit-01/finance/*
represents all objects that can be accessed under prefixunit-01/finance/
for the Multi-Region Access Point with aliasmfzwi23gnjvgw.mrap
, in account123456789012
.
Multi-Region Access Point hostnames
You can access data in Amazon S3 through a Multi-Region Access Point using the hostname of the Multi-Region Access Point. Requests can be directed to this hostname from the public internet or from a virtual private cloud (VPC) if you have configured one or more internet gateways for the Multi-Region Access Point. For more information about creating VPC interface endpoints to use with Multi-Region Access Points, see Configuring a Multi-Region Access Point for use with AWS PrivateLink.
You can also make requests through a Multi-Region Access Point from a VPC using AWS PrivateLink if you have
configured a VPC endpoint. Be aware that with requests to a Multi-Region Access Point
using AWS PrivateLink, you cannot directly use an endpoint-specific Regional DNS ending
with
. This hostname
will not have a cert associated with it so it cannot be used directly. You can still use the
public DNS name of the VPC endpoint as a <Region>
.vpce.amazonaws.comCNAME
or ALIAS
target. Alternatively, you
can enable private DNS on the endpoint and use the standard Multi-Region Access Point
DNS
names as described below.
<MRAP_alias>
.accesspoint.s3-global.amazonaws.com
When you use the REST APIs for Amazon S3 data operations (for example,
GetObject
) through a Multi-Region Access Point, the hostname for the request is
.
For example, to make a <MRAP_alias>
.accesspoint.s3-global.amazonaws.comGetObject
request through the Multi-Region Access Point with alias
mfzwi23gnjvgw.mrap
, make a request to the hostname
mfzwi23gnjvgw.mrap.accesspoint.s3-global.amazonaws.com
. Note the s3-global
portion of the hostname that indicates this hostname is not for a specific Region.
Making requests through a Multi-Region Access Point is similar to making requests through a single-Region access point. It is important to be aware of the following differences:
-
Multi-Region Access Point ARNs don’t include an AWS Region. They follow the format
arn:aws:s3::
.<account-id>
:accesspoint/<MRAP_alias>
-
For requests made through the REST APIs (this does not require the use of an ARN), Multi-Region Access Points use a different endpoint scheme. The scheme is
—for example,<MRAP_alias>
.accesspoint.s3-global.amazonaws.commfzwi23gnjvgw.mrap.accesspoint.s3-global.amazonaws.com
. Note the differences compared to a single-Region access point:-
Multi-Region Access Point hostnames use their alias, not the Multi-Region Access Point name.
-
Multi-Region Access Point hostnames don’t include the owner’s AWS account ID.
-
Multi-Region Access Point hostnames don’t include an AWS Region.
-
Multi-Region Access Point hostnames include
s3-global.amazonaws.com
instead ofs3.amazonaws.com
.
-
-
Requests must be signed using Signature Version 4A (SigV4A). When you use the AWS SDK, the SDK automatically converts a SigV4 signature to SigV4A. For more information about SigV4A, see Signing AWS API requests in the AWS General Reference.
Multi-Region Access Points and Amazon S3 Transfer Acceleration
Amazon S3 Transfer Acceleration is a feature that enables fast transfer of data to buckets. It is configured on the individual bucket level and you can use it to transfer objects faster to buckets. To read more about Transfer Acceleration, see Configuring fast, secure file transfers using Amazon S3 Transfer Acceleration.
When dealing with Multi-Region Access Points, it is important to know that Multi-Region Access Points use a similar accelerated transfer mechanism as Transfer Acceleration for sending large objects over the AWS network. Because of this, you don't need to perform any special configuration or handling to gain the benefits of the faster transfer rates when sending requests through a Multi-Region Access Point. This increased performance is automatically incorporated into the Multi-Region Access Point.
Topics