Python的AWS SDK
项目描述
Boto3是Amazon Web Services(AWS)的Python软件开发工具包(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
安装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 问题跟踪错误和功能请求,并有限的处理带宽来解决这个问题。请在获取帮助时使用这些社区资源
在 Stack Overflow 上提问,并标记为 boto3
通过 AWS Support 打开支持工单
如果结果显示您可能发现了一个错误,请 打开一个问题
贡献
我们重视社区反馈和贡献。无论是错误报告、新功能、纠正还是额外的文档,我们都欢迎您的问题和拉取请求。在提交任何问题或拉取请求之前,请阅读此 CONTRIBUTING 文档,以确保我们拥有所有必要的有效响应您的贡献的信息。
SDK 主版本的维护和支持
Boto3 于 2015 年 6 月 22 日正式发布,目前处于可用生命周期的全面支持阶段。
有关 SDK 主版本及其底层依赖项的维护和支持信息,请参阅 AWS SDKs 和 Tools Shared Configuration and Credentials Reference Guide 中的以下内容
更多资源
项目详情
下载文件
下载适合您平台的文件。如果您不确定该选择哪个,请了解更多关于安装包的信息。