博托3

Boto3 - 适用于 Python 的 AWS 开发工具包

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

安装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 开具支持票证
• 如果您发现了错误，请提出问题

贡献

我们重视社区的反馈和贡献。无论是错误报告、新功能、更正还是附加文档，我们都欢迎您提出问题和拉取请求。在提交任何问题或拉取请求之前，请仔细阅读此贡献文档，以确保我们拥有有效回应您的贡献的所有必要信息。

SDK主要版本维护与支持

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

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

• AWS 开发工具包和工具维护政策
• AWS 开发工具包和工具版本支持列表

更多资源

• 注意
• 变更日志
• 执照