Boto3-适用于Python的AWS SDK
Boto3是适用于Python的Amazon Web Services(AWS)软件开发工具包(SDK),允许Python开发人员编写利用Amazon S3和Amazon EC2等服务的软件。您可以在我们的doc site,包括支持的服务列表
2021年1月15日宣布了对Python2.7的弃用,2021年7月15日将放弃对Python2.7的支持。为了避免中断,在Python2.7上使用Boto3的客户可能需要升级他们的Python版本或固定Boto3的版本。有关更多信息,请参阅此blog post
快速入门
假设您有Python和virtualenv
安装,设置您的环境并安装所需的依赖项,如下所示,或者您可以使用以下命令安装库pip
:
$ git clone https://github.com/boto/boto3.git
$ cd boto3
$ virtualenv venv
...
$ . venv/bin/activate
$ python -m pip install -r requirements.txt
$ python -m pip install -e .
$ python -m pip install boto3
使用Boto3
安装boto3之后
接下来,设置凭据(例如~/.aws/credentials
):
[default] aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET
然后,设置默认区域(例如,~/.aws/config
):
[default] region=us-east-1
可以找到其他凭证配置方法here
然后,从Python解释器执行以下操作:
>>> import boto3 >>> s3 = boto3.resource('s3')
>>> for bucket in s3.buckets.all():
print(bucket.name)
运行测试
您可以使用在所有支持的Python版本中运行测试tox
默认情况下,它将运行所有单元测试和功能测试,但您也可以指定自己的测试nosetests
选项。请注意,这要求您安装了所有受支持的Python版本,否则您必须通过-e
或运行nosetests
命令直接执行:
$ tox
$ tox -- unit/test_session.py
$ tox -e py26,py33 -- integration/
您还可以使用默认的Python版本运行单独的测试:
$ nosetests tests/unit
获取帮助
我们使用GitHub问题来跟踪错误和功能请求,但解决这些问题的带宽有限。请使用以下社区资源获取帮助:
- 问一个关于…的问题Stack Overflow并给它贴上标签boto3
- 加入AWS Python社区聊天室gitter
- 使用打开支持票证AWS Support
- 如果发现您可能发现了错误,请open an issue
贡献
我们重视来自社区的反馈和贡献。无论是错误报告、新功能、更正还是其他文档,我们都欢迎您的问题和请求。请把这个通读一遍CONTRIBUTING在提交任何问题或拉回请求之前提交文档,以确保我们拥有有效回应您的贡献的所有必要信息
SDK主要版本的维护和支持
Boto3于2015年6月22日正式发布,目前处于可用性生命周期的全面支持阶段
有关SDK主要版本及其底层依赖项的维护和支持信息,请参阅《AWS SDK和工具共享配置和凭证参考指南》中的以下内容: