Usar pontos de acesso com operações compatíveis com o Amazon S3 - Amazon Simple Storage Service

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 Amazon S3 permitem que as aplicações que exijam um nome de bucket do S3 use um ponto de acesso com facilidade. É possível usar aliases de ponto de acesso do S3 onde você usa nomes de bucket do S3 para acessar dados no S3. Para ter mais informações, consulte Casos de uso e limitações de alias de ponto de acesso.

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

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