Boto3 — это комплект разработки программного обеспечения (SDK) Amazon Web Services (AWS) для Python, который позволяет разработчикам Python писать программное обеспечение, использующее такие сервисы, как Amazon S3 и Amazon EC2. На нашем сайте документации вы можете найти новейшую и самую актуальную документацию, включая список поддерживаемых сервисов.
Boto3 поддерживается и публикуется Amazon Web Services.
Бото (произносится как бо-то) был назван в честь пресноводного дельфина, обитающего в реке Амазонка. Название было выбрано автором оригинальной библиотеки Boto Митчем Гарнаатом как отсылку к компании.
13 декабря 2023 г. поддержка Python 3.7 для Boto3 закончилась. Это следует за прекращением поддержки среды выполнения Python Software Foundation, которое произошло 27 июня 2023 г. Для получения дополнительной информации см. эту публикацию в блоге.
Предполагая, что у вас установлена поддерживаемая версия Python, вы можете сначала настроить свою среду с помощью:
$ python -m venv .venv
...
$ . .venv/bin/activateЗатем вы можете установить boto3 из PyPI с помощью:
$ python -m pip install boto3или установите из исходного кода с помощью:
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ python -m pip install -r requirements.txt
$ python -m pip install -e .После установки бото3
Затем настройте учетные данные (например, ~/.aws/credentials ):
[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET Затем настройте регион по умолчанию (например, ~/.aws/config ):
[default]
region =us-east-1Другие методы настройки учетных данных можно найти здесь.
Затем из интерпретатора Python:
>> > import boto3
>> > s3 = boto3 . resource ( 's3' )
>> > for bucket in s3 . buckets . all ():
print ( bucket . name ) Вы можете запускать тесты во всех поддерживаемых версиях Python, используя tox . По умолчанию он запускает все модульные и функциональные тесты, но вы также можете указать свои собственные параметры pytest . Обратите внимание: для этого необходимо, чтобы у вас были установлены все поддерживаемые версии Python, в противном случае вам придется передать -e или запустить команду pytest напрямую:
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/Вы также можете запустить отдельные тесты с версией Python по умолчанию:
$ pytest tests/unitМы используем проблемы GitHub для отслеживания ошибок и запросов функций и имеем ограниченную пропускную способность для их устранения. Чтобы получить помощь, воспользуйтесь этими ресурсами сообщества:
Мы ценим отзывы и вклад нашего сообщества. Будь то отчет об ошибке, новая функция, исправление или дополнительная документация, мы приветствуем ваши проблемы и запросы на внесение изменений. Пожалуйста, прочтите этот документ «ВКЛАД», прежде чем отправлять какие-либо вопросы или запросы на включение, чтобы убедиться, что у нас есть вся необходимая информация для эффективного реагирования на ваш вклад.
Boto3 стал общедоступным 22.06.2015 и в настоящее время находится на этапе полной поддержки жизненного цикла доступности.
Информацию об обслуживании и поддержке основных версий SDK и их базовых зависимостей см. в справочном руководстве по общей конфигурации и учетным данным AWS SDK и инструментов:
