命令行选项 - AWS Command Line Interface
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

命令行选项

您可以使用以下命令行选项来覆盖一条命令的默认配置设置。虽然您可以指定要使用的配置文件,但无法使用命令行选项直接指定凭证。

--profile <string>

指定用于该命令的命名配置文件。要设置其他命名配置文件,可以在 aws configure 命令中使用 --profile 选项。

$ aws configure --profile <profilename>
--region <string>

指定要将该命令的 AWS 请求发送到的 AWS 区域。有关可以指定的所有区域的列表,请参阅Amazon Web Services 一般参考中的 AWS 区域和终端节点

--output <string>

指定用于该命令的输出格式。您可以指定以下任意值:

  • json – 输出采用 JSON 字符串的格式。

  • yaml – 输出采用 YAML 字符串的格式。(仅在 AWS CLI 版本 2 中可用。)

  • text – 输出采用多个制表符分隔字符串值行的格式。这对于将输出传递到文本处理器(如 grepsedawk)很有用。

  • table – 输出采用表格形式,使用字符 +|- 以形成单元格边框。它通常以“人性化”格式呈现信息,这种格式比其他格式更容易阅读,但从编程方面来讲不是那么有用。

--endpoint-url <string>

指定要将请求发送到的 URL。对于大多数命令,AWS CLI 会根据所选服务和指定的 AWS 区域自动确定 URL。但是,某些命令需要您指定账户专用 URL。您还可以配置一些 AWS 服务直接在您的私有 VPC 中托管终端节点(然后可能需要指定该终端节点)。

有关每个区域可用的标准服务终端节点的列表,请参阅Amazon Web Services 一般参考中的 AWS 区域和终端节点

--debug

启用调试日志记录的布尔开关。这包括有关命令操作的额外诊断信息,这些信息在排查命令提供意外结果的原因时非常有用。

--no-paginate

禁用对输出进行自动分页的布尔开关。

--query <string>

指定用于筛选响应数据的 JMESPath 查询。有关更多信息,请参阅 如何使用 --query 选项筛选输出

--version

显示正在运行的 AWS CLI 程序的当前版本的布尔开关。

--color <string>

指定对彩色输出的支持。有效值包括 onoffauto。默认值为 auto

--no-sign-request

对 AWS 服务终端节点的 HTTP 请求禁用签名的布尔开关。这可避免加载凭证。

--ca-bundle <string>

指定验证 SSL 证书时要使用的证书颁发机构 (CA) 证书捆绑包。

--cli-read-timeout <integer>

指定最大套接字读取时间(以秒为单位)。如果该值设置为零 (0),则套接字读取将无限等待(阻塞),不会超时。

--cli-connect-timeout <integer>

指定最大套接字连接时间(以秒为单位)。如果该值设置为零 (0),则套接字连接将无限等待(阻塞),不会超时。

当将这些选项中的一个或多个作为命令行参数提供时,它们会覆盖该单个命令的默认配置、任何相应的配置文件设置或环境变量设置。

每个带参数的选项都需要一个空格或等号 (=) 将参数与选项名称分开。如果参数值为包含空格的字符串,则必须使用引号将参数引起来。

常见的命令行选项用法包括在编写脚本时检查多个 AWS 区域中的资源,以及更改输出格式使其易于阅读或使用。例如,如果您不确定实例运行的区域,可以针对每个区域运行 describe-instances 命令,直到找到该区域,如下所示。

$ aws ec2 describe-instances --output table --region us-east-1 ------------------- |DescribeInstances| +-----------------+ $ aws ec2 describe-instances --output table --region us-west-1 ------------------- |DescribeInstances| +-----------------+ $ aws ec2 describe-instances --output table --region us-west-2 ------------------------------------------------------------------------------ | DescribeInstances | +----------------------------------------------------------------------------+ || Reservations || |+-------------------------------------+------------------------------------+| || OwnerId | 012345678901 || || ReservationId | r-abcdefgh || |+-------------------------------------+------------------------------------+| ||| Instances ||| ||+------------------------+-----------------------------------------------+|| ||| AmiLaunchIndex | 0 ||| ||| Architecture | x86_64 ||| ...

为 AWS CLI 指定参数值 通用 AWS CLI 参数类型中详细描述了每个命令行选项的参数类型(例如,字符串、布尔值)。