Usar puntos de acceso con operaciones compatibles con Amazon S3 - Amazon Simple Storage Service

Usar puntos de acceso con operaciones compatibles con Amazon S3

Los siguientes ejemplos muestran cómo utilizar puntos de acceso con operaciones compatibles en Amazon S3.

Compatibilidad del punto de acceso con servicios de AWS

Los alias de puntos de acceso de Amazon S3 permiten que cualquier aplicación que requiera un nombre de bucket de S3 utilice un punto de acceso fácilmente. Puede usar alias de punto de acceso de S3 donde utilice nombres de bucket de S3 para acceder a los datos en S3. Para obtener más información, consulte Casos de uso y limitaciones de alias de punto de acceso.

Compatibilidad de los puntos de acceso con las operaciones de S3

Puede utilizar puntos de acceso para acceder a un bucket mediante el siguiente subconjunto de API de Amazon S3. Todas las operaciones enumeradas a continuación aceptan ARN de puntos de acceso o alias de puntos de acceso:

Operaciones de S3

Solicitar un objeto a través de un punto de acceso

En el ejemplo siguiente se muestra cómo solicitar el objeto my-image.jpg a través del punto de acceso prod que es propiedad del ID de cuenta 123456789012 de la región us-west-2; a continuación, guarda el archivo descargado 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

Carga de un objeto mediante un alias de punto de acceso

En el ejemplo siguiente, se carga el objeto my-image.jpg mediante el alias de punto de acceso my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias propiedad del ID de cuenta 123456789012 en la región us-west-2.

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

Eliminar un objeto a través de un punto de acceso

En el ejemplo siguiente se muestra cómo eliminar el objeto my-image.jpg a través del punto de acceso prod que es propiedad del ID de cuenta 123456789012 de la región us-west-2.

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

Enumeración de objetos mediante un alias de punto de acceso

En el ejemplo siguiente, se enumeran los objetos mediante el alias de punto de acceso my-access-point-hrzrlukc5m36ft7okagglf3gmwluquse1b-s3alias propiedad del ID de cuenta 123456789012 en la región us-west-2.

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

Agregar un conjunto de etiquetas a un objeto a través de un punto de acceso

En el ejemplo siguiente se muestra cómo agregar un conjunto de etiquetas al objeto my-image.jpg existente a través del punto de acceso prod que es propiedad del ID de cuenta 123456789012 de la región 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 permisos de acceso a través de un punto de acceso mediante una ACL

En el ejemplo siguiente se muestra cómo aplicar una ACL a un objeto my-image.jpg existente a través del punto de acceso prod que es propiedad de ID de cuenta 123456789012 de la región 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