Boto3 es el kit de desarrollo de software (SDK) de Amazon Web Services (AWS) para Python, que permite a los desarrolladores de Python escribir software que utilice servicios como Amazon S3 y Amazon EC2. Puede encontrar la documentación más reciente y actualizada en nuestro sitio de documentación, incluida una lista de servicios compatibles.
Boto3 es mantenido y publicado por Amazon Web Services.
Boto (pronunciado boh-toh) lleva el nombre del delfín de agua dulce nativo del río Amazonas. El nombre fue elegido por el autor de la biblioteca Boto original, Mitch Garnaat, como referencia a la empresa.
El 13 de diciembre de 2023, finalizó el soporte para Python 3.7 para Boto3. Esto se produce tras el fin del soporte de Python Software Foundation para el tiempo de ejecución que se produjo el 27 de junio de 2023. Para obtener más información, consulte esta publicación de blog.
Suponiendo que tiene instalada una versión compatible de Python, primero puede configurar su entorno con:
$ python -m venv .venv
...
$ . .venv/bin/activateLuego, puedes instalar boto3 desde PyPI con:
$ python -m pip install boto3o instalar desde la fuente con:
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ python -m pip install -r requirements.txt
$ python -m pip install -e .Después de instalar boto3
A continuación, configure las credenciales (por ejemplo, ~/.aws/credentials ):
[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET Luego, configure una región predeterminada (por ejemplo, ~/.aws/config ):
[default]
region =us-east-1Otros métodos de configuración de credenciales se pueden encontrar aquí
Luego, desde un intérprete de Python:
>> > import boto3
>> > s3 = boto3 . resource ( 's3' )
>> > for bucket in s3 . buckets . all ():
print ( bucket . name ) Puede ejecutar pruebas en todas las versiones de Python compatibles usando tox . De forma predeterminada, ejecutará todas las pruebas funcionales y unitarias, pero también puede especificar sus propias opciones pytest . Tenga en cuenta que esto requiere que tenga instaladas todas las versiones compatibles de Python; de lo contrario, debe pasar -e o ejecutar el comando pytest directamente:
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/También puedes ejecutar pruebas individuales con tu versión predeterminada de Python:
$ pytest tests/unitUsamos los problemas de GitHub para rastrear errores y solicitudes de funciones y tenemos un ancho de banda limitado para solucionarlos. Utilice estos recursos comunitarios para obtener ayuda:
Valoramos los comentarios y contribuciones de nuestra comunidad. Ya sea un informe de error, una nueva característica, una corrección o documentación adicional, agradecemos sus problemas y solicitudes de extracción. Lea este documento de CONTRIBUCIÓN antes de enviar cualquier problema o solicitud de extracción para asegurarse de que tengamos toda la información necesaria para responder de manera efectiva a su contribución.
Boto3 estuvo disponible de forma general el 22/06/2015 y actualmente se encuentra en la fase de soporte completo del ciclo de vida de disponibilidad.
Para obtener información sobre el mantenimiento y la compatibilidad con las versiones principales del SDK y sus dependencias subyacentes, consulte lo siguiente en la Guía de referencia de credenciales y configuración compartida de SDK y herramientas de AWS:
