Usar pontos de acesso com operações compatíveis com o Amazon S3

Os exemplos a seguir demonstram como usar pontos de acesso com operações compatíveis no Amazon S3.

Compatibilidade com ponto de acesso com produtos da AWS

Os aliases de pontos de acesso do Amazon S3 permitem que qualquer aplicação que exija um nome de bucket do S3 use um ponto de acesso com facilidade. É possível usar aliases de ponto de acesso do S3 em qualquer lugar em que você use nomes de bucket do S3 para acessar dados no S3.

Compatibilidade de ponto de acesso com operações do S3

Você pode usar pontos de acesso para acessar um bucket usando o seguinte subconjunto de APIs do Amazon S3. Todas as operações listadas abaixo podem aceitar ARNs de ponto de acesso ou aliases de ponto de acesso:

Operações do S3

• AbortMultipartUpload

• CompleteMultipartUpload

• CopyObject (somente cópias da mesma região)

• CreateMultipartUpload

• DeleteObject

• DeleteObjectTagging

• GetBucketAcl

• GetBucketCors

• GetBucketLocation

• GetBucketNotificationConfiguration

• GetBucketPolicy

• GetObject

• GetObjectAcl

• GetObjectLegalHold

• GetObjectRetention

• GetObjectTagging

• HeadBucket

• HeadObject

• ListMultipartUploads

• ListObjects

• ListObjectsV2

• ListParts

• Presign

• PutObject

• PutObjectLegalHold

• PutObjectRetention

• PutObjectAcl

• PutObjectTagging

• RestoreObject

• UploadPart

• UploadPartCopy (somente cópias da mesma região)

Solicitar um objeto por meio de um ponto de acesso

O exemplo a seguir solicita o objeto my-image.jpg por meio do ponto de acesso prod pertencente ao ID de conta 123456789012 na região us-west-2 e salva o arquivo obtido por download como download.jpg.

AWS CLI

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

Fazer upload de um objeto por meio de um alias de ponto de acesso

O exemplo a seguir faz upload do objeto my-image.jpg por meio do alias de ponto de acesso my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias pertencente ao ID de conta 123456789012 na região us-west-2.

AWS CLI

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

Excluir um objeto por meio de um ponto de acesso

O exemplo a seguir exclui o objeto my-image.jpg por meio do ponto de acesso prod pertencente ao ID de conta 123456789012 na região us-west-2.

AWS CLI

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

Listar objetos por meio de um alias de ponto de acesso

O exemplo a seguir lista objetos por meio do alias de ponto de acesso my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias pertencente ao ID de conta 123456789012 na região us-west-2.

AWS CLI

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

Adicionar um conjunto de tags a um objeto por meio de um ponto de acesso

O exemplo a seguir adiciona um conjunto de tags ao objeto existente my-image.jpg por meio do ponto de acesso prod pertencente ao ID de conta 123456789012 na região 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"}]

Conceder permissões de acesso por meio de um ponto de acesso usando uma ACL

O exemplo a seguir aplica uma ACL a um objeto existente my-image.jpg por meio do ponto de acesso prod pertencente ao ID de conta 123456789012 na região 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