中的指令結構 AWS CLI

本主題介紹 AWS Command Line Interface (AWS CLI) 命令的構造方式，以及如何使用 wait 命令。

命令結構

在命令行上 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 my-bucket
2018-12-14 14:55:44 my-bucket2

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

AWS CloudFormation

以下命令示例將雲形堆棧名稱更改為 my-change-set.

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

若要取得 AWS CloudFormation 指令的更多資訊，請參閱《指AWS CLI 令參考》中的〈〉。

等候命令

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

會在指令行上 AWS CLI 使用多部分結構來處理必須以下列順序指定的指wait令：

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

2. 頂層指令，通常對應於支援的 AWS 服務 AWS CLI。

3. wait 命令。

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

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

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

參數可以採用各種類型的輸入值，例如數字，字符串，列表，地圖和JSON結構。支援哪些項目取決於您指定的命令和子命令。

注意

並非每個AWS服務都支援wait指令。請參閱第 2 AWS CLI 版參考指南，瞭解您的服務是否支援指wait令。

範例

AWS CloudFormation

下列命令範例只有在可以確認 my-change-set 在中設定的變更 my-stack 堆棧已準備好運行。

$ 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

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

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

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