中的命令結構 AWS CLI - AWS Command Line Interface
命令結構等候命令

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

中的命令結構 AWS CLI

本主題涵蓋如何建構 AWS Command Line Interface (AWS CLI) 命令，以及如何使用等待命令。

命令結構

在命令列上使用 AWS CLI 分段結構，必須依此順序指定：

  1. 對 aws 程式的基本呼叫。

  2. 最上層命令，通常對應至 支援 AWS 的服務 AWS CLI。

  3. 指定執行哪些操作的子命令。

  4. 操作所需的一般 AWS CLI 選項或參數。只要位在前三個部分後面，您可以依任意順序指定這些項目。如果排他參數受到多次指定，只會套用最終數值。

$ aws <command> <subcommand> [options and parameters]

參數採用各種類型的輸入數值，例如數字、字串、清單、映射和 JSON 結構。支援哪些項目取決於您指定的命令和子命令。

Amazon Simple Storage Service (Amazon S3)

以下範例列出您的所有 Amazon S3 儲存貯體。

$ aws s3 ls
2018-12-11 17:08:50 amzn-s3-demo-bucket1
2018-12-14 14:55:44 amzn-s3-demo-bucket2

如需 Amazon S3 命令的詳細資訊，請參閱 AWS CLI 命令參考中的 aws s3。

AWS CloudFormation

以下 create-change-set 命令範例會將 cloudformation 堆疊名稱變更為 my-change-set。

$ aws cloudformation create-change-set --stack-name my-stack --change-set-name my-change-set

如需 AWS CloudFormation 命令的詳細資訊，請參閱《 AWS CLI 命令參考aws cloudformation》中的 。

等候命令

有些 AWS 服務有可用的wait命令。任何使用 aws wait 的命令通常都會等到命令完成後，再進行下一個步驟。這對於分段命令或指令碼特別有用，因為如果等候命令失敗，您可以使用等候命令來避免進行後續步驟。

對於必須依此順序指定的wait命令， AWS CLI 會在命令列上使用分段結構：

  1. 對 aws 程式的基本呼叫。

  2. 最上層命令，通常對應至 支援 AWS 的服務 AWS CLI。

  3. wait 命令。

  4. 指定執行哪些操作的子命令。

  5. 操作所需的一般 CLI 選項或參數。只要位在前三個部分後面，您可以依任意順序指定這些項目。如果排他參數受到多次指定，只會套用最終數值。

$ aws <command> wait <subcommand> [options and parameters]

參數採用各種類型的輸入數值，例如數字、字串、清單、映射和 JSON 結構。支援哪些項目取決於您指定的命令和子命令。

注意

並非所有 AWS 服務都支援 wait 命令。請參閱第 AWS CLI 2 版參考指南，了解您的服務是否支援 wait 命令。

AWS CloudFormation

以下 wait change-set-create-complete 命令範例會暫停，且僅在可確認 my-stack 堆疊中的 my-change-set 變更集已準備好執行後，才會繼續執行。

$ aws cloudformation wait change-set-create-complete --stack-name my-stack --change-set-name my-change-set

如需 AWS CloudFormation wait 命令的詳細資訊，請參閱 AWS CLI 命令參考中的 wait。

AWS CodeDeploy

以下 wait deployment-successful 命令範例會暫停，直到 d-A1B2C3111 成功完成部署。

$ aws deploy wait deployment-successful --deployment-id d-A1B2C3111

如需 AWS CodeDeploy wait 命令的詳細資訊，請參閱 AWS CLI 命令參考中的 wait。