ARN、アクセスポイントエイリアス、または仮想ホスト形式の URI を使用した汎用バケットのアクセスポイントの参照

汎用バケットのアクセスポイントを作成したら、これらのエンドポイントを使用してさまざまなオペレーションを実行できます。汎用バケットのアクセスポイントを参照するときは、Amazon リソースネーム (ARN)、アクセスポイントエイリアス、または仮想ホスト形式の URI を使用できます。

汎用バケットのアクセスポイント ARN

アクセスポイントには Amazon リソースネーム (ARN) があります。汎用バケットのアクセスポイントの ARN は、バケットの ARN と似ていますが、明示的に型指定され、アクセスポイントの AWS リージョンとアクセスポイントの所有者の AWS アカウント ID をエンコードします。ARN の詳細については、「AWS 全般のリファレンス」の「Amazon リソースネーム (ARN)」を参照してください。

アクセスポイント ARN は、以下の形式を使用します。

arn:aws:s3:region:account-id:accesspoint/resource

アクセスポイントを介してアクセスされるオブジェクトの ARN は、以下の形式を使用します。

arn:aws:s3:region:account-id:accesspoint/access-point-name/object/resource

汎用バケットのアクセスポイントのエイリアス

汎用バケットのアクセスポイントを作成すると、Amazon S3 はデータアクセス用の Amazon S3 バケット名の代わりに使用できるエイリアスを自動的に生成します。このアクセスポイントエイリアスは、アクセスポイントのデータプレーンオペレーションにおいて、Amazon リソースネーム (ARN) の代わりに使用することができます。これらのオペレーションのリストについては、「汎用バケットのアクセスポイントの互換性」を参照してください。

アクセスポイントのエイリアス名は、Amazon S3 バケットと同じ名前空間内に作成されます。このエイリアス名は自動的に生成され、変更できません。アクセスポイントのエイリアス名は、有効な Amazon S3 バケット名のすべての要件を満たしており、次の部分で構成されています。

access point prefix-metadata-s3alias

汎用バケットのアクセスポイントのエイリアスに関するユースケースと制限事項

汎用バケットのアクセスポイントを採用する場合、大幅なコード変更を必要とせずに、アクセスポイントのエイリアス名を使用できます。

汎用バケットのアクセスポイントを作成すると、次の例に示すように、Amazon S3 によってアクセスポイントのエイリアス名が自動的に生成されます。このコマンドを実行するには、user input placeholders をユーザー自身の情報に置き換えます。

aws s3control create-access-point --bucket amzn-s3-demo-bucket1 --name my-access-point --account-id 111122223333
{
    "AccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point",
    "Alias": "my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias"
}

このアクセスポイントのエイリアス名は、あらゆるデータプレーンオペレーションにおいて、Amazon S3 のバケット名の代わりに使用することができます。これらのオペレーションのリストについては、汎用バケットのアクセスポイントの互換性 を参照してください。

次の get-object コマンドの AWS CLI 例では、バケットのアクセスポイントエイリアスを使用して、指定されたオブジェクトに関する情報を返します。このコマンドを実行するには、user input placeholders をユーザー自身の情報に置き換えます。

aws s3api get-object --bucket my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias --key dir/my_data.rtf my_data.rtf
            
{
    "AcceptRanges": "bytes",
    "LastModified": "2020-01-08T22:16:28+00:00",
    "ContentLength": 910,
    "ETag": "\"00751974dc146b76404bb7290f8f51bb\"",
    "VersionId": "null",
    "ContentType": "text/rtf",
    "Metadata": {}
}

アクセスポイントエイリアスの制限

仮想ホスティング形式の URI

汎用バケットのアクセスポイントでは、仮想ホスト形式のアドレス指定のみがサポートされます。仮想ホスティング形式の URI では、アクセスポイント名、AWS アカウント、AWS リージョンは URL のドメイン名の一部です。仮想ホスティングの詳細については、「バケットの仮想ホスティング」を参照してください。

アクセスポイントの仮想ホスト形式の URI は、次の形式を使用します。

https://access-point-name-account-id.s3-accesspoint.region.amazonaws.com