Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Ejemplo de creación de scripts para el ciclo de vida de un bucket de Amazon S3 en el AWS CLI
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
. Los scripts de shell son programas diseñados para ejecutarse en una interfaz de línea de comandos.
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, actualización y desinstalación del AWS CLI y Credenciales de autenticación y acceso para AWS CLI.
-
El perfil que utilice debe tener permisos que permitan realizar las AWS operaciones que se realizan en los ejemplos.
-
Como práctica AWS recomendada, conceda a este código los privilegios mínimos o solo los permisos necesarios para realizar una tarea. Para obtener más información, consulte Concesión de privilegios mínimos en la Guía del IAM usuario.
-
Este código no se ha probado en todas AWS las regiones. Algunos AWS servicios 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 generar cargos en su AWS cuenta. 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 ver el ejemplo completo y los archivos de script descargables, consulte Amazon S3 Bucket Lifecycle Operations
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.sh
on GitHub. -
- test-bucket-operations.sh
-
El archivo de script de shell
test-bucket-operations.sh
muestra cómo llamar a las funciones mediante el suministro de archivobucket-operations.sh
y 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.sh
on. GitHub
- awsdocs-general.sh
-
El archivo de script
awsdocs-general.sh
contiene funciones de uso general utilizadas en ejemplos de código avanzados para la AWS CLI.Ver el código de
awsdocs-general.sh
on GitHub.
Referencias
AWS CLI referencia:
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 ejemplos de AWS CLI código AWS SDK y contribuir a ellos, consulte el repositorio AWS de ejemplos de código
en GitHub.