**本文件 AWS CLI 僅適用於 第 1 版。** 我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至 第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 [公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。如需 第 2 版的相關文件 AWS CLI，請參閱 第 [2 版使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 什麼是 AWS Command Line Interface版本 1？ **注意** AWS CLI 第 1 版不是最新版本的 AWS CLI。由於在 AWS CLI 第 2 版中推出的某些功能無法回溯至第 1 版，因此您必須升級才能存取這些功能。第 1 版有一些「重大」變更，可能需要變更您的指令碼。如需第 2 版重大變更的清單，請參閱 *AWS CLI 第 2 版使用者指南*中的[重大變更](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration.html)。 AWS Command Line Interface (AWS CLI) 是一種開放原始碼工具，可讓您使用命令列 shell 中的命令與 AWS 服務互動。透過最少的 AWS CLI 組態， 可讓您從終端機程式中的命令提示字元，開始執行實作相當於瀏覽器型 所提供功能的 AWS 管理主控台 命令： + **Linux Shell** – 使用常見的 Shell 程式 (例 [https://www.gnu.org/software/bash/](https://www.gnu.org/software/bash/)、[http://www.zsh.org/](http://www.zsh.org/) 和 [https://www.tcsh.org/](https://www.tcsh.org/))，在 Linux 或 macOS 中執行命令。 + **Windows 命令列** – 在 Windows 上，於 Windows 命令提示或 PowerShell 中執行命令。 + **遠端** – 透過遠端終端程式 (例如 PuTTY 或 SSH) 或使用 AWS Systems Manager，在 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體上執行命令。 API 和 AWS 管理主控台 提供 中所有 IaaS （基礎設施即服務） AWS 管理、管理和存取函數 AWS AWS CLI。New AWS IaaS 功能和服務會在啟動時或在啟動後 180 天內透過 API 和 CLI 提供完整 AWS 管理主控台 功能。 AWS CLI 可讓您直接存取 AWS 服務的公APIs。您可以使用 探索服務的功能 AWS CLI，並開發 shell 指令碼來管理您的 資源。除了低階 API 同等命令之外，數個 AWS 服務還提供 的自訂功能 AWS CLI。自訂功能可能包括較高階的命令，可簡化具有複雜 API 的服務使用。 ## 關於第 1 AWS CLI 版 第 1 AWS CLI 版是原始版本 AWS CLI，我們會繼續支援它。不過，第 2 AWS CLI 版中引進的主要新功能可能無法回溯到第 1 AWS CLI 版。若要使用這些功能，您必須安裝 第 2 AWS CLI 版。第 1 AWS CLI 版使用適用於 Python 的 SDK 建置，因此需要您安裝相容的 Python 版本。 若要安裝第 1 AWS CLI 版，請參閱 [安裝、更新和解除安裝 AWS CLI](cli-chap-install.md)。 若要檢查目前已安裝的版本，請使用下列命令： ``` $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6 ``` 如需版本歷程記錄，請參閱 *GitHub* 上的 [AWS CLI 第 1 版變更記錄](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst)。 ## 開發套件主要版本的維護與支援 如需開發套件主要版本及其基礎相依性之維護與支援的相關資訊，請參閱《[AWS 開發套件及工具參考指南](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html)》中的以下內容： + [AWS SDKs和工具維護政策](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html) + [AWS SDKs和工具版本支援矩陣](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html) ## Amazon Web Services 簡介 Amazon Web Services (AWS) 集合了各項數位基礎設施服務，讓開發人員可在開發應用程式時加以利用。服務包括運算、儲存、資料庫和應用程式同步 （訊息和佇列）。 AWS 使用pay-as-you-go服務模型。您只需為您 (或您應用程式) 使用的服務付費。此外，為了讓 成為 AWS 更接近的原型設計和實驗平台， AWS 提供免費用量方案。在此方案中，特定用量層級以下的服務皆為免費。如需 AWS 成本和 免費方案的詳細資訊，請參閱 [AWS 免費方案](https://aws.amazon.com/free/)。若要取得 AWS 帳戶，請開啟[AWS 首頁](https://aws.amazon.com/)，然後選擇**建立 AWS 帳戶**。 # 關於 AWS CLI 使用者指南中的範例 本指南中的 AWS Command Line Interface (AWS CLI) 範例使用下列慣例編排格式： + **提示** – 命令提示使用 Linux 提示字元，並顯示為 (`$ `)。對於 Windows 特有的命令，`C:\>` 將其用作提示。鍵入命令時，請不要包含該提示。 + **目錄** – 命令必須從特定的目錄執行時，該目錄名稱會顯示在提示符號的前方。 + **使用者輸入** – 於命令列輸入的命令文字採用 **user input** 格式。 + **可取代文字** – 變數文字 (包含您所選的資源名稱，或您必須納入命令中之 AWS 服務所產生的 ID) 格式採用*可取代文字*。在多行命令或需要特定鍵盤輸入的命令中，鍵盤命令也可以顯示為可取代文字。 + **輸出** – 由 AWS 服務傳回的輸出會顯示在使用者輸入的下方，並且格式為 `computer output`。 下列 **aws configure** 命令範例示範了使用者輸入、可取代文字以及輸出： 1. 請在命令列中輸入 **aws configure**，再按下 **Enter**。 1. AWS CLI 輸出文字行，提示您輸入其他資訊。 1. 請依次輸入各個存取金鑰，並按下 **Enter**。 1. 接著，以顯示的格式輸入 AWS 區域名稱，按下 **Enter**，然後最後一次按下 **Enter** 以略過輸出格式設定。 1. 最終 **Enter** 命令會顯示為可取代文字，因為該行沒有使用者輸入。 ``` $ aws configure AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY Default region name [None]: us-west-2 Default output format [None]: ENTER ``` 下面的例子顯示輸出中有一個簡單的命令。若要使用此範例，請輸入命令的完整文字 (提示後方反白顯示的文字)，並按下 **Enter**。安全性群組的名稱 *`my-sg`* 可用您想要的安全群組名稱取代。JSON 文件 (包含大括弧) 為輸出。如果您將 CLI 設為以文字格式或表格格式輸出，則輸出的格式將會有所差異。[JSON](https://json.org) 為預設輸出格式。 ``` $ aws ec2 create-security-group --group-name my-sg --description "My security group" { "GroupId": "sg-903004f8" } ``` # 的其他文件和資源 AWS CLI ## AWS CLI 文件和資源 除了本使用者指南以外，以下是使用 AWS CLI時寶貴的線上資源。 + [AWS CLI 第 1 版參考指南](https://docs.aws.amazon.com/cli/v1/reference/) + [AWS CLI Bash 指令碼程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli)。開放原始碼 bash 指令碼範例。Bash 指令碼範例託管於 *GitHub* 上的 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples)中。 + [AWS CLI GitHub 儲存庫](https://github.com/aws/aws-cli)。您可以在 *GitHub* AWS CLI 上檢視和撥出 的原始程式碼。加入 *GitHub* 的使用者社群，即可提供意見回饋、請求功能並提交您的專屬貢獻。這包括檢視和提供 AWS CLI 文件的命令範例。 + [AWS CLI 別名範例儲存庫](https://github.com/awslabs/awscli-aliases) 您可以在 *GitHub* AWS CLI 上檢視 和 分支別名範例。 + [AWS CLI 第 1 版變更日誌](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst) + [AWS CLI 第 2 版變更日誌](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) ## AWS SDKs和工具 根據您的使用案例，您可能想要選擇其中一個 AWS SDKs或工具，以更符合您的需求： + [AWS SDKs和工具參考指南](https://docs.aws.amazon.com/sdkref/latest/guide/) + [適用於 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-cpp) + [適用於 Go 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-go/api/) + [適用於 Java 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) + [適用於 JavaScript 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) + [適用於 Kotlin 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-kotlin) + [適用於 .NET 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) + [適用於 Python (Boto) 的 AWS SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) + [適用於 PHP 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) + [AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/) + [適用於 Ruby 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) + [適用於 Rust 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-rust) + [適用於 SAP ABAP 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-sapabap) + [適用於 Swift 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-swift) + [AWS Amplify](https://docs.amplify.aws/swift/)