标签归档:aws-sdk

Boto3 适用于Python的AWS 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和工具共享配置和凭证参考指南》中的以下内容:

更多资源