AWS Command Line Interface
用户指南

命令行选项

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

--profile <string>

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

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

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

--output <string>

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

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

  • 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 ||| ...

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