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

本文档仅适用于 Amazon CLI 版本 1。有关 Amazon CLI 版本 2 的相关文档,请参阅版本 2 用户指南

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 参考指南,了解您的服务是否支持 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