github

Boto3 适用于Python的AWS SDK

内容 隐藏
Boto3-适用于Python的AWS SDK
快速入门
使用Boto3
运行测试
获取帮助
贡献
SDK主要版本的维护和支持
更多资源

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问题来跟踪错误和功能请求，但解决这些问题的带宽有限。请使用以下社区资源获取帮助：

贡献

我们重视来自社区的反馈和贡献。无论是错误报告、新功能、更正还是其他文档，我们都欢迎您的问题和请求。请把这个通读一遍CONTRIBUTING在提交任何问题或拉回请求之前提交文档，以确保我们拥有有效回应您的贡献的所有必要信息

SDK主要版本的维护和支持

Boto3于2015年6月22日正式发布，目前处于可用性生命周期的全面支持阶段

有关SDK主要版本及其底层依赖项的维护和支持信息，请参阅《AWS SDK和工具共享配置和凭证参考指南》中的以下内容：

更多资源