Verwenden von Zugriffspunkten mit kompatiblen Amazon S3-Vorgänge

Die folgenden Beispiele veranschaulichen, wie Zugriffspunkte mit kompatiblen Vorgängen in Amazon S3 verwendet werden.

Kompatibilität des Access Points mit Diensten AWS

Mit Aliasnamen von Amazon-S3-Zugriffspunkten können Anwendungen, die einen S3-Bucketnamen benötigen, problemlos einen Zugriffspunkt verwenden. Sie können S3-Zugriffspunkt-Aliasnamen überall verwenden, wo Sie S3-Bucketnamen verwenden, um auf Daten in S3 zuzugreifen. Weitere Informationen finden Sie unter Zugriffspunkt-Alias-Anwendungsfälle und -beschränkungen.

Zugriffspunkt-Kompatibilität mit S3-Vorgänge

Sie können Access Points verwenden, um mithilfe der folgenden Teilmenge von Amazon S3 APIs auf einen Bucket zuzugreifen. Alle unten aufgeführten Operationen können entweder Access Point ARNs - oder Access Point-Aliase akzeptieren:

S3-Operationen

• AbortMultipartUpload

• CompleteMultipartUpload

• CopyObject(Nur Kopien derselben Region)

• CreateMultipartUpload

• DeleteObject

• DeleteObjects

• DeleteObjectTagging

• GetBucketAcl

• GetBucketCors

• GetBucketLocation

• GetBucketNotificationConfiguration

• GetBucketPolicy

• GetObject

• GetObjectAcl

• GetObjectAttributes

• GetObjectLegalHold

• GetObjectRetention

• GetObjectTagging

• HeadBucket

• HeadObject

• ListMultipartUploads

• ListObjects

• ListObjectsV2

• ListObjectVersions

• ListParts

• Presign

• PutObject

• PutObjectAcl

• PutObjectLegalHold

• PutObjectRetention

• PutObjectTagging

• RestoreObject

• UploadPart

• UploadPartCopy(Nur Kopien aus derselben Region)

Anfordern eines Objekts über einen Zugriffspunkt

Im folgenden Beispiel wird das Objekt angefordert my-image.jpg durch den Access Point Prod gehört der Konto-ID 123456789012 in der Region us-west-2, und speichert die heruntergeladene Datei als download.jpg.

AWS CLI

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

Hochladen eines Objekts über einen Zugriffspunkt-Alias

Das folgende Beispiel lädt das Objekt hoch my-image.jpg über den Access Point-Alias, der der Konto-ID my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias gehört 123456789012 in der Region us-west-2.

AWS CLI

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

Löschen eines Objekts über einen Zugriffspunkt

Im folgenden Beispiel wird das Objekt gelöscht my-image.jpg durch den Access Point Prod gehört der Konto-ID 123456789012 in der Region us-west-2.

AWS CLI

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

Auflisten von Objekten über einen Zugriffspunkt-Alias

Im folgenden Beispiel werden Objekte anhand des Access Point-Alias aufgelistet, der der Konto-ID my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias gehört 123456789012 in der Region us-west-2.

AWS CLI

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

Hinzufügen eines Tag-Satzes zu einem Objekt über einen Zugriffspunkt

Im folgenden Beispiel wird dem vorhandenen Objekt ein Tag-Set hinzugefügt my-image.jpg durch den Access Point Prod gehört der Konto-ID 123456789012 in der Region us-west-2.

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"}]

Erteilen Sie Zugriffsberechtigungen über einen Access Point mithilfe eines ACL

Im folgenden Beispiel wird ein ACL auf ein vorhandenes Objekt angewendet my-image.jpg durch den Access Point Prod gehört der Konto-ID 123456789012 in der Region us-west-2.

AWS CLI

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