View a markdown version of this page

常规配置设置 - Amazon 软件开发工具包和工具
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

常规配置设置

注意

要帮助理解设置页面的布局或解释后面的 Su pport by Amazon SDK 和工具表,请参阅了解本指南的设置页面

SDK 支持一些用于配置 SDK 整体性能的常规设置。

使用以下方法配置此功能:

api_versions-共享 Amazon config文件设置

有些 Amazon 服务维护多个 API 版本以支持向后兼容。默认情况下,SDK 和 Amazon CLI 操作使用最新的可用 API 版本。如要求使用特定的 API 版本来处理您的请求,请在您的个人资料中添加该 api_versions 设置。

默认值:无。(SDK 使用的最新 API 版本。)

有效值:这是一个嵌套设置,后面有一行或多行缩进,每行标识一项 Amazon 服务和要使用的 API 版本。要了解有哪些 API 版本可用,请参阅该 Amazon 服务的文档。

该示例为config文件中的两个 Amazon 服务设置了特定的 API 版本。这些 API 版本仅用于在包含这些设置的配置文件下运行的命令。任何其他服务的命令都使用该服务的 API 的最新版本。

api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
ca_bundle-共享 Amazon config文件设置
AWS_CA_BUNDLE - 环境变量

指定在建立 SSL/TLS 连接时使用的自定义证书包(带有.pem扩展名的文件)的路径。

默认值:

有效值:指定完整路径或基本文件名。如果存在基本文件名,则系统会尝试在 PATH 环境变量指定的文件夹中查找该程序。

config 文件中设置此值的示例:

[default] ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

由于操作系统的路径处理方式和路径字符转义方式方面的差异,以下是在 Windows 上的 config 文件中设置此值的示例:

[default] ca_bundle = C:\\Users\\username\\.aws\\aws-custom-bundle.pem

Linux/macOS 通过命令行设置环境变量的示例:

export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pem

Windows 通过命令行设置环境变量的示例:

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem
output-共享 Amazon config文件设置

指定结果在以及其他 Amazon SDK Amazon CLI 和工具中的格式设置。

默认值json

有效值:

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

  • yaml – 输出采用 YAML 字符串的格式。

  • yaml-stream – 输出被流式处理并采用 YAML 字符串的格式。串流支持更快地处理大型数据类型。

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

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

parameter_validation-共享 Amazon config文件设置

指定 SDK 或工具在将命令行参数发送到 Amazon 服务端点之前是否尝试验证这些参数。

默认值true

有效值:

  • true – 默认值。SDK 或工具执行命令行参数的客户端验证。这有助于 SDK 或工具确认参数是否有效,并捕获一些错误。SDK 或工具可以在向 Amazon 服务端点发送请求之前拒绝无效的请求。

  • false— SDK 或工具在将命令行参数发送到 Amazon 服务端点之前不会对其进行验证。 Amazon 服务端点负责验证所有请求并拒绝无效的请求。

Support by Amazon SDK 和工具

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 适用于 Java 的 Amazon SDK 和 适用于 Kotlin 的 Amazon SDK 唯一支持任何 JVM 系统属性设置。

SDK 支持 备注或更多信息
Amazon CLI v2 部分 api_versions 不支持。
适用于 C++ 的 SDK
适用于 Go V2 (1.x) 的 SDK 部分 不支持 api_versionsparameter_validation
适用于 Go 1.x(V1)的 SDK 部分 不支持 api_versionsparameter_validation。要使用共享 config 文件设置,必须开启从配置文件加载的功能;请参阅会话
适用于 Java 2.x 的 SDK
适用于 Java 1.x 的 SDK
适用于 JavaScript 3.x 的软件开发工具包
适用于 JavaScript 2.x 的 SDK
适用于 Kotlin 的 SDK
适用于.NET 4.x 的 SDK
适用于 .NET 3.x 的 SDK
适用于 PHP 3.x 的 SDK
适用于 Python (Boto3) 的 SDK
适用于 Ruby 3.x 的 SDK
适用于 Rust 的 SDK
适用于 Swift 的 SDK
适用于 PowerShell V5 的工具
适用于 PowerShell V4 的工具