Boto3 は、Python 用のアマゾン ウェブ サービス (AWS) ソフトウェア開発キット (SDK) であり、Python 開発者はこれを使用して、Amazon S3 や Amazon EC2 などのサービスを利用するソフトウェアを作成できます。サポートされているサービスのリストを含む最新のドキュメントは、ドキュメント サイトで見つけることができます。
Boto3 はアマゾン ウェブ サービスによって維持および公開されます。
ボト(ボートーと発音)は、アマゾン川に生息する淡水イルカにちなんで名付けられました。この名前は、オリジナルの Boto ライブラリの著者である Mitch Garnaat によって、会社にちなんで選ばれました。
2023 年 12 月 13 日に、Boto3 の Python 3.7 のサポートが終了しました。これは、2023 年 6 月 27 日に発生した Python Software Foundation のランタイムのサポート終了に続くものです。詳細については、このブログ投稿を参照してください。
サポートされているバージョンの Python がインストールされていると仮定すると、まず以下を使用して環境をセットアップできます。
$ python -m venv .venv
...
$ . .venv/bin/activate
次に、次のコマンドを使用して PyPI から boto3 をインストールできます。
$ 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 .
boto3のインストール後
次に、認証情報を設定します (例: ~/.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 )
tox
使用すると、サポートされているすべての Python バージョンでテストを実行できます。デフォルトでは、すべての単体テストと機能テストが実行されますが、独自のpytest
オプションを指定することもできます。これには、サポートされているすべてのバージョンの Python がインストールされている必要があることに注意してください。そうでない場合は、 -e
を渡すか、 pytest
コマンドを直接実行する必要があります。
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/
デフォルトの Python バージョンを使用して個別のテストを実行することもできます。
$ pytest tests/unit
私たちはバグや機能リクエストの追跡に GitHub の問題を使用していますが、それらに対処するための帯域幅は限られています。ヘルプが必要な場合は、次のコミュニティ リソースをご利用ください。
私たちはコミュニティからのフィードバックや貢献を大切にしています。バグレポート、新機能、修正、追加ドキュメントのいずれであっても、問題やプルリクエストを歓迎します。あなたの貢献に効果的に対応するために必要な情報がすべて揃っていることを確認するために、問題やプル リクエストを送信する前にこの貢献ドキュメントをよく読んでください。
Boto3 は 2015 年 6 月 22 日に一般公開され、現在は可用性ライフサイクルの完全サポート段階にあります。
SDK メジャー バージョンとその基礎となる依存関係のメンテナンスとサポートの詳細については、AWS SDK およびツールの共有設定および認証情報リファレンス ガイドの以下を参照してください。