호환되는 Amazon S3 작업에 액세스 포인트 사용

다음 예제에서는 Amazon S3에서 호환되는 작업에 액세스 포인트를 사용하는 방법을 보여 줍니다.

AWS 서비스와의 액세스 포인트 호환성

Amazon S3 액세스 포인트 별칭을 사용하면 S3 버킷 이름이 필요한 모든 애플리케이션에서 액세스 포인트를 쉽게 사용할 수 있습니다. S3 버킷 이름을 사용하는 곳에서 S3 액세스 포인트 별칭을 사용하여 S3의 데이터에 액세스할 수 있습니다. 자세한 내용은 액세스 포인트 별칭 사용 사례 및 제한 단원을 참조하십시오.

S3 작업과의 액세스 포인트 호환성

액세스 포인트를 사용하여 다음 Amazon S3 API 하위 집합을 사용하는 버킷에 액세스할 수 있습니다. 아래 나열된 모든 작업은 액세스 포인트 ARN 또는 액세스 포인트 별칭을 수락할 수 있습니다.

S3 작업

• AbortMultipartUpload

• CompleteMultipartUpload

• CopyObject(동일한 리전 사본만 해당)

• CreateMultipartUpload

• DeleteObject

• 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(동일한 리전 사본만 해당)

액세스 포인트를 통해 객체 요청

다음 예제에서는 리전 us-west-2의 계정 ID 123456789012에서 소유한 액세스 포인트 prod를 통해 객체 my-image.jpg를 요청하는 방법을 보여주며 다운로드한 파일을 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

액세스 포인트를 통해 객체 삭제

다음 예제에서는 리전 us-west-2의 계정 ID 123456789012에서 소유한 액세스 포인트 prod를 통해 객체 my-image.jpg를 삭제합니다.

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 123456789012에서 소유한 액세스 포인트 prod를 통해 기존 객체 my-image.jpg에 ACL을 적용합니다.

AWS CLI

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