aws cli
1.0.0
该软件包为 Amazon Web Services 提供了统一的命令行界面。
跳转至：
本自述文件适用于 AWS CLI 版本 1。如果您正在查找有关 AWS CLI 版本 2 的信息，请访问 v2 分支。
aws-cli 包适用于 Python 版本：
2022 年 5 月 30 日，终止对 Python 3.6 的支持。在此之前，Python 软件基金会于 2021 年 12 月 23 日终止了对运行时的支持。
2023 年 12 月 13 日，终止对 Python 3.7 的支持。在此之前，Python 软件基金会于 2023 年 6 月 27 日结束了对运行时的支持。有关更多信息，请参阅此博客文章。
注意力！
我们建议所有客户定期监控Amazon Web Services 安全公告网站，以获取与 aws-cli 相关的任何重要安全公告。
AWS CLI 版本 1 于 2013 年 9 月 2 日全面发布，目前处于可用性生命周期的全面支持阶段。
有关开发工具包主要版本及其底层依赖项的维护和支持的信息，请参阅AWS 开发工具包和工具共享配置和凭证参考指南中的维护策略部分。
AWS CLI 及其依赖项的安装使用pip和setuptools提供的一系列打包功能。为保证安装顺利，建议使用：
pip ：9.0.2 或更高setuptools ：36.2.0 或更高版本安装 AWS CLI 最安全的方法是在virtualenv中使用 pip ：
$ python -m pip 安装 awscli
或者，如果您没有在virtualenv中安装，则全局安装：
$ sudo python -m pip install awscli
或者对于您的用户：
$ python -m pip install --user awscli
如果您已安装 aws-cli 软件包并想要升级到最新版本，您可以运行：
$ python -m pip install --upgrade awscli
这将安装 aws-cli 软件包以及所有依赖项。
笔记
在 macOS 上，如果您在 El Capitan 中看到有关distutils附带的six版本的错误，请使用--ignore-installed选项：
$ sudo python -m pip install awscli --忽略安装的六个
在 Linux 和 Mac OS 上，可以使用捆绑安装程序安装 AWS CLI。 AWS CLI 还可以通过 MSI 安装程序安装在 Windows 上。
如果您想运行 AWS CLI 的develop分支，请参阅贡献指南的开发版本部分。
有关更多信息，请参阅 AWS CLI 用户指南的安装部分。
在使用 AWS CLI 之前，您需要配置 AWS 凭证。您可以通过多种方式执行此操作：
最快的入门方法是运行aws configure命令：
$ aws配置 AWS 访问密钥 ID：MYACCESSKEY AWS 秘密访问密钥：MYSECRETKEY 默认区域名称[us-west-2]：us-west-2 默认输出格式[无]：json
要使用环境变量，请执行以下操作：
$ 导出 AWS_ACCESS_KEY_ID=<访问密钥> $ 导出 AWS_SECRET_ACCESS_KEY=<秘密密钥>
要使用共享凭据文件，请创建一个 INI 格式的文件，如下所示：
[默认] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY [测试] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
并将其放置在~/.aws/credentials中（或者在 Windows 上放置在%UserProfile%.aws/credentials中）。如果您希望将共享凭证文件放置在与上面指定的位置不同的位置，则需要告诉 aws-cli 在哪里可以找到它。通过设置适当的环境变量来做到这一点：
$ 导出 AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
要使用配置文件，请创建一个 INI 格式的文件，如下所示：
[默认] aws_access_key_id=<默认访问密钥> aws_secret_access_key=<默认密钥> # 可选，为此配置文件定义默认区域。 区域=us-west-1 [配置文件测试] aws_access_key_id=<测试访问密钥> aws_secret_access_key=<测试密钥> 区域=us-west-2
并将其放置在~/.aws/config中（或者在 Windows 上放置在%UserProfile%.awsconfig中）。如果您希望将配置文件放置在与上面指定的位置不同的位置，则需要告诉 AWS CLI 在哪里可以找到它。通过设置适当的环境变量来做到这一点：
$ 导出 AWS_CONFIG_FILE=/path/to/config_file
如您所见，您可以在共享凭据文件和配置文件中定义多个profiles 。然后，您可以使用--profile选项指定要使用的配置文件。如果未指定配置文件，则使用default文件。
在配置文件中，除默认配置文件外，您必须在配置文件组的每个配置部分前面加上profile前缀。例如，如果您有一个名为“testing”的配置文件，则节标题将为[profile testing] 。
如果您在 EC2 实例上使用 AWS CLI，则强烈建议使用最后一个凭证选项。 IAM 角色是在实例上自动安装凭证的好方法。如果您使用 IAM 角色，AWS CLI 将自动查找并使用它们。
除了凭据之外，还可以使用环境变量和/或配置文件条目来配置许多其他变量。有关更多信息，请参阅 AWS 工具和开发工具包共享配置和凭证参考指南。
有关配置选项的更多信息，请参阅 AWS CLI 配置变量主题。您也可以通过运行aws help config-vars从 AWS CLI 访问此主题。
AWS CLI 命令具有以下结构：
$ aws <命令> <子命令> [选项和参数]
例如，要列出 S3 存储桶，命令为：
$ aws s3 ls
要查看帮助文档，请使用以下方法之一：
$ AWS 帮助 $ aws <命令> 帮助 $ aws <命令> <子命令> 帮助
要获取 AWS CLI 的版本：
$ aws --版本
要打开调试输出：
$ aws --debug <命令> <子命令>
您可以阅读有关 AWS CLI 用户指南的使用 AWS CLI 章节的更多信息。
aws-cli 软件包包含适用于类 Unix 系统的命令完成功能。此功能不会自动安装，因此您需要手动配置。要了解更多信息，请阅读 AWS CLI 命令完成主题。
与我们团队互动的最佳方式是通过 GitHub。您可以打开问题并从我们的模板中进行选择以获取指导、错误报告或功能请求。
您可以从 Stack Overflow 上带有 aws-cli 标签的社区或 AWS CLI 讨论论坛上找到帮助。如果您有 AWS Support 的支持计划，您还可以创建新的支持案例。
在打开另一个问题之前，请检查是否存在类似的问题。
AWS CLI 实现 AWS 服务 API。对于有关服务或其限制的一般问题，您可能会发现 Amazon Web Services 讨论论坛很有帮助。
