Amazon CLI 中的命令结构 - Amazon Command Line Interface
命令结构Wait 命令
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon CLI 中的命令结构

本主题介绍如何构造 Amazon Command Line Interface (Amazon CLI) 命令，以及如何使用 wait 命令。

命令结构

Amazon CLI 在命令行上使用多部分结构，各部分必须按如下顺序指定：

  1. 对 aws 计划的基本调用。

  2. 顶级命令，这通常对应于 Amazon CLI 支持的Amazon服务。

  3. 用于指定要执行的操作的子命令。

  4. 常规 Amazon 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 命令的更多信息，请参阅 Amazon CLI 命令参考 中的 aws s3。

Amazon CloudFormation

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

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

有关 Amazon CloudFormation 命令的更多信息，请参阅 Amazon CLI 命令参考 中的 aws cloudformation。

Wait 命令

一些 Amazon 服务提供 wait 命令。使用 aws wait 的任何命令通常都会等到命令完成后再进入下一步。这对于多部分命令或脚本编写来说特别有用，因为当命令失败时，您可以使用 wait 命令阻止进入后续步骤。

Amazon CLI 在命令行上对 wait 命令使用多部分结构，各部分必须按如下顺序指定：

  1. 对 aws 计划的基本调用。

  2. 顶级命令，这通常对应于 Amazon CLI 支持的Amazon服务。

  3. wait 命令。

  4. 用于指定要执行的操作的子命令。

  5. 常规 CLI 选项或操作所需的参数。您可以按任意顺序指定这些项，只要它们跟在前三个部分之后。如果多次指定某个排他参数，则仅应用最后一个值。

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

参数可采用各种类型的输入值，如数字、字符串、列表、映射和 JSON 结构。支持的内容取决于您指定的命令和子命令。

注意

并不是所有 AWS 服务都支持 wait 命令。请参阅 Amazon CLI 版本 2 参考指南，了解您的服务是否支持 wait 命令。

Amazon 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

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

Amazon CodeDeploy

在下面的 wait deployment-successful 命令示例中，命令将暂停运行，直到 d-A1B2C3111 部署成功完成。

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

有关 Amazon CodeDeploy wait 命令的更多信息，请参阅《Amazon CLI 命令参考》中的 wait。