适用于AWS的通用命令行环境。
项目描述
此包提供了一个统一的命令行界面来访问亚马逊网络服务。
跳转到
入门
此README是为AWS CLI版本1准备的。如果您正在寻找AWS CLI版本2的信息，请访问v2分支。
要求
aws-cli包适用于以下Python版本
3.8.x及更高版本
3.9.x及更高版本
3.10.x及更高版本
3.11.x及更高版本
3.12.x及更高版本
通知
2022年5月30日，对Python 3.6的支持已结束。这是遵循Python软件基金会于2021年12月23日发生的运行时支持结束。
2023年12月13日，对Python 3.7的支持已结束。这是遵循Python软件基金会于2023年6月27日发生的运行时支持结束。有关更多信息，请参阅此博客文章。
注意！
我们建议所有客户定期监控 亚马逊网络服务安全公告网站 中与aws-cli相关的任何重要安全公告。
CLI主要版本的维护和支持
AWS CLI版本1于2013年9月2日发布，目前处于可用生命周期的完全支持阶段。
有关SDK主要版本及其依赖项的维护和支持信息，请参阅《AWS SDKs和工具共享配置和凭证参考指南》中的维护策略部分。
安装
AWS CLI及其依赖项的安装使用了由pip和setuptools提供的多种打包功能。为确保安装顺利，建议使用以下版本：
pip：9.0.2或更高版本
setuptools：36.2.0或更高版本
安装AWS CLI最安全的方法是使用pip在virtualenv中
$ python -m pip install awscli
或者，如果您不在virtualenv中安装，可以全局安装
$ sudo python -m pip install awscli
或者为您的用户安装
$ python -m pip install --user awscli
如果您已安装aws-cli包并希望升级到最新版本，可以运行
$ python -m pip install --upgrade awscli
这将安装aws-cli包及其所有依赖项。
$ sudo python -m pip install awscli --ignore-installed six
在Linux和Mac OS上，可以使用捆绑安装程序安装AWS CLI。AWS CLI还可以通过MSI安装程序在Windows上安装。
如果您想运行AWS CLI的develop分支，请参阅贡献指南中的开发版本部分。
有关更多信息，请参阅AWS CLI用户指南的安装部分。
配置
在使用AWS CLI之前，您需要配置AWS凭证。您可以通过以下几种方式完成此操作：
配置命令
环境变量
共享凭证文件
配置文件
IAM角色
最快的方法是运行aws configure命令
$ aws configure AWS Access Key ID: MYACCESSKEY AWS Secret Access Key: MYSECRETKEY Default region name [us-west-2]: us-west-2 Default output format [None]: json
要使用环境变量，请执行以下操作：
$ export AWS_ACCESS_KEY_ID=<access_key> $ export AWS_SECRET_ACCESS_KEY=<secret_key>
要使用共享凭证文件，创建一个如下所示的INI格式文件
[default] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY [testing] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
并将其放置在~/.aws/credentials（或在Windows上的%UserProfile%\.aws/credentials）中。如果您希望将共享凭证文件放置在上述指定的不同位置，您需要告诉aws-cli在哪里可以找到它。通过设置相应的环境变量来完成此操作
$ export AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
要使用配置文件，创建一个如下所示的INI格式文件
[default] aws_access_key_id=<default access key> aws_secret_access_key=<default secret key> # Optional, to define default region for this profile. region=us-west-1 [profile testing] aws_access_key_id=<testing access key> aws_secret_access_key=<testing secret key> region=us-west-2
并将其放置在~/.aws/config（或在Windows上的%UserProfile%\.aws\config）中。如果您希望将配置文件放置在上述指定的不同位置，您需要告诉AWS CLI在哪里可以找到它。通过设置相应的环境变量来完成此操作
$ export AWS_CONFIG_FILE=/path/to/config_file
如您所见，您可以在共享凭据文件和配置文件中定义多个配置文件。然后，您可以通过使用--profile选项来指定要使用哪个配置文件。如果没有指定配置文件，将使用默认配置文件。
在配置文件中，除了默认配置文件外，您必须使用profile作为配置文件组的每个配置部分的名称前缀。例如，如果您有一个名为“testing”的配置文件，则部分标题将是[profile testing]。
如果您在EC2实例上使用AWS CLI，则强烈推荐使用凭据的最后一个选项。IAM角色是将凭据自动安装在实例上的好方法。如果您使用IAM角色，AWS CLI将自动找到并使用它们。
除了凭据外，还可以通过环境变量、配置文件条目或两者同时配置其他一些变量。有关更多信息，请参阅AWS工具和SDK共享配置和凭据参考指南。
有关配置选项的更多信息，请参阅AWS CLI配置变量主题。您也可以通过运行aws help config-vars从AWS CLI访问此主题。
基本命令
AWS CLI命令具有以下结构
$ aws <command> <subcommand> [options and parameters]
例如，要列出S3存储桶，命令将是
$ aws s3 ls
要查看帮助文档，请使用以下之一
$ aws help $ aws <command> help $ aws <command> <subcommand> help
要获取AWS CLI版本
$ aws --version
要开启调试输出
$ aws --debug <command> <subcommand>
您可以在AWS CLI用户指南的使用AWS CLI章节中找到更多信息。
命令补全
aws-cli包包括Unix-like系统的命令补全功能。此功能不是自动安装的，因此您需要手动配置它。要了解更多信息，请阅读AWS CLI命令补全主题。
获取帮助
与我们的团队互动的最佳方式是通过GitHub。您可以打开一个问题，并从我们的模板中选择指导、错误报告或功能请求。
您可以在Stack Overflow上找到社区的帮助，标签为aws-cli，或者在AWS CLI论坛上。如果您有与AWS Support的支持计划，您还可以创建新的支持案例。
在打开另一个问题之前，请检查是否有类似的问题已打开。
AWS CLI实现了AWS服务API。对于关于服务或其限制的一般问题，您可能会发现Amazon Web Services论坛很有用。
更多资源
下载文件
下载适合您平台文件的文件。如果您不确定选择哪个，请了解有关安装包的更多信息。