中的命令结构 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 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

以下命令示例将 cloudformation 堆栈名称更改为 my-change-set.

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

有关命令的更多信息，请参阅《 AWS CloudFormation AWS CLI 命令参考》中的。

Wait 命令

有些 AWS 服务有可用的wait命令。使用 aws wait 的任何命令通常都会等到命令完成后再进入下一步。这对于多部分命令或脚本编写来说特别有用，因为当命令失败时，您可以使用 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。