En este tema se utiliza un ejemplo de scripting de Bash para las operaciones del ciclo de vida del bucket de Amazon S3 mediante la AWS Command Line Interface (AWS CLI). En este ejemplo de scripting se utiliza el conjunto de comandos de aws s3api
Antes de comenzar
Antes de que pueda ejecutar cualquiera de los siguientes ejemplos, se debe completar lo siguiente.
Instalar y configurar la AWS CLI. Para obtener más información, consulte Instalación o actualización de la versión más reciente de AWS CLI y Credenciales de autenticación y acceso para la AWS CLI.
-
El perfil que utilice debe tener permisos que permitan que se realicen las operaciones de la AWS mediante ejemplos.
-
Como práctica recomendada de AWS, conceda a este código privilegios mínimos o solo los permisos necesarios para llevar a cabo una tarea. Para obtener más información, consulte Concesión de mínimos privilegios en la Guía del usuario de IAM.
-
Este código no se ha probado en todas las regiones de AWS. Algunos servicios de AWS solo están disponibles en regiones específicas. Para obtener más información, consulte Puntos de enlace de servicio y cuotas en la Guía de referencia general de AWS.
-
La ejecución de este código puede resultar en cargos en su cuenta de AWS. Es su responsabilidad asegurarse de que los recursos creados por este script se eliminen cuando haya terminado con ellos.
El servicio Amazon S3 utiliza los siguientes términos:
-
Bucket: una carpeta de Amazon S3 de nivel superior.
-
Prefijo: una carpeta de Amazon S3 en un bucket.
-
Objeto: cualquier artículo alojado en un bucket de Amazon S3.
Acerca de este ejemplo
En este ejemplo se muestra cómo interactuar con algunas de las operaciones básicas de Amazon S3 mediante un conjunto de funciones en archivos de script de shell. Las funciones se encuentran en el archivo de script de shell llamado bucket-operations.sh. Puede llamar a estas funciones en otro archivo. Cada archivo de script contiene comentarios que describen cada una de las funciones.
Para ver los resultados intermedios de cada paso, ejecute el script con un parámetro -i. Para ver el estado actual del bucket o su contenido, puede usar la consola de Amazon S3. El scripting solo pasa al siguiente paso cuando se pulsa Enter (Intro) en el símbolo del sistema.
Para obtener el ejemplo completo y los archivos de script descargables, consulte Operaciones del ciclo de vida de bucket de Amazon S3
Archivos
El ejemplo contiene los siguientes archivos:
- bucket-operations.sh
-
Este archivo de script principal puede obtenerse de otro archivo. Incluye funciones que realizan las siguientes tareas:
-
Creación de un bucket y verificación de que existe
-
Copia de un archivo desde el equipo local a un bucket
-
Copia de un archivo desde una ubicación de bucket a otra ubicación de bucket
-
Listado de contenidos de un bucket
-
Eliminación a archivos desde un bucket
-
Eliminación de un bucket
Vea el código de
bucket-operations.shen GitHub. -
- test-bucket-operations.sh
-
El archivo de script de shell
test-bucket-operations.shmuestra cómo llamar a las funciones mediante el suministro de archivobucket-operations.shy el llamando a cada una de las funciones. Después de llamar a las funciones, el script de prueba elimina todos los recursos que creó.Vea el código de
test-bucket-operations.shen GitHub.
- awsdocs-general.sh
-
El archivo de script
awsdocs-general.shcontiene funciones de uso general utilizadas en ejemplos de código avanzados para la AWS CLI.Vea el código de
awsdocs-general.shen GitHub.
Referencias
referencia de AWS CLI:
Otra referencia:
-
Uso de buckets de Amazon S3 en la Guía del usuario de Amazon S3
-
Uso de objetos de Amazon S3 en la Guía del usuario de Amazon S3
-
Para ver y contribuir al AWS SDK y los ejemplos de código de AWS CLI, consulte el Repositorio de ejemplos de código de AWS
en GitHub.
