aws cli
1.0.0
該軟體包為 Amazon Web Services 提供了統一的命令列介面。
跳轉至：
本自述文件適用於 AWS CLI 版本 1。
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 討論論壇很有幫助。
