Boto3 是適用於 Python 的 Amazon Web Services (AWS) 軟體開發套件 (SDK),它允許 Python 開發人員編寫使用 Amazon S3 和 Amazon EC2 等服務的軟體。您可以在我們的文件網站找到最新的文檔,包括支援的服務清單。
Boto3 由 Amazon Web Services 維護和發布。
Boto(發音為 boh-toh)以原產於亞馬遜河的淡水海豚命名。這個名字是由原始 Boto 庫的作者 Mitch Garnaat 選擇的,作為對公司的參考。
2023 年 12 月 13 日,Boto3 終止對 Python 3.7 的支援。在此之前,Python 軟體基金會於 2023 年 6 月 27 日終止了對運行時的支援。有關更多信息,請參閱此部落格文章。
假設您安裝了受支援的 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 日全面發布,目前處於可用性生命週期的全面支援階段。
有關開發工具包主要版本及其底層相依性的維護和支援的信息,請參閱 AWS 開發工具包和工具共享配置和憑證參考指南中的以下內容: