互換性のある Amazon S3 オペレーションによるアクセスポイントの使用

以下の例は、Amazon S3 の互換性のあるオペレーションでアクセスポイントを使用する方法を示しています。

AWS サービスとアクセスポイントの互換性

Amazon S3 アクセスポイントのエイリアスを使用すると、S3 バケット名を必要とするすべてのアプリケーションでアクセスポイントを簡単に使用できます。S3 のデータにアクセスするために S3 バケット名を使用する任意の場所で、S3 アクセスポイントのエイリアスを使用できます。詳細については、「アクセスポイントエイリアスの使用例と制限事項」を参照してください。

S3 オペレーションとアクセスポイントの互換性

アクセスポイントを介して、次の Amazon S3 API のサブセットを使用してバケットにアクセスできます。以下に示すすべてのオペレーションで、アクセスポイント ARN またはアクセスポイントエイリアスのいずれかを許可できます。

S3 オペレーション

• AbortMultipartUpload

• CompleteMultipartUpload

• CopyObject (同じリージョンへのコピーのみ)

• CreateMultipartUpload

• DeleteObject

• DeleteObjects

• DeleteObjectTagging

• GetBucketAcl

• GetBucketCors

• GetBucketLocation

• GetBucketNotificationConfiguration

• GetBucketPolicy

• GetObject

• GetObjectAcl

• GetObjectAttributes

• GetObjectLegalHold

• GetObjectRetention

• GetObjectTagging

• HeadBucket

• HeadObject

• ListMultipartUploads

• ListObjects

• ListObjectsV2

• ListObjectVersions

• ListParts

• Presign

• PutObject

• PutObjectLegalHold

• PutObjectRetention

• PutObjectAcl

• PutObjectTagging

• RestoreObject

• UploadPart

• UploadPartCopy (同じリージョンへのコピーのみ)

アクセスポイントを使用したオブジェクトのリクエスト

次の例では、my-image.jpg リージョンのアカウント ID prod が所有するアクセスポイント 123456789012 を使用してオブジェクト us-west-2 をリクエストし、ダウンロードしたファイルを download.jpg として保存します。

AWS CLI

aws s3api get-object --key my-image.jpg --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod download.jpg

アクセスポイントエイリアスを使用したオブジェクトのアップロード

次の例では、リージョン us-west-2 のアカウント ID 123456789012 が所有するアクセスポイントエイリアス my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias を使用してオブジェクト my-image.jpg をアップロードします。

AWS CLI

aws s3api put-object --bucket my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias --key my-image.jpg --body my-image.jpg

アクセスポイントを使用したオブジェクトの削除

次の例では、my-image.jpg リージョンのアカウント ID prod が所有するアクセスポイント 123456789012 を使用してオブジェクト us-west-2 を削除します。

AWS CLI

aws s3api delete-object --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod --key my-image.jpg

アクセスポイントエイリアスを使用したオブジェクトの一覧表示

次の例では、リージョン us-west-2 のアカウント ID 123456789012 が所有するアクセスポイントエイリアス my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias を使用してオブジェクトを一覧表示します。

AWS CLI

aws s3api list-objects-v2 --bucket my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias

アクセスポイントを使用したオブジェクトへのタグセットの追加

次の例では、us-west-2 リージョンのアカウント ID 123456789012 が所有するアクセスポイント prod を使用して既存のオブジェクト my-image.jpg にタグセットを追加します。

AWS CLI

aws s3api put-object-tagging --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod --key my-image.jpg --tagging TagSet=[{Key="finance",Value="true"}]

アクセスポイントを使用した ACL によるアクセス許可の付与

次の例では、us-west-2 リージョンのアカウント ID prod が所有するアクセスポイント my-image.jpg を使用して既存のオブジェクト 123456789012 に ACL を適用します。

AWS CLI

aws s3api put-object-acl --bucket arn:aws:s3:us-west-2:123456789012:accesspoint/prod --key my-image.jpg --acl private