常规配置设置 - AWS SDKs和工具

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

常规配置设置

SDKs支持一些用于配置整体SDK行为的常规设置。

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

api_versions-共享 AWS config文件设置

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

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

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

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

api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
ca_bundle-共享 AWS 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-共享 AWS config文件设置

指定结果的格式化方式 AWS CLI 和其他 AWS SDKs和工具。

默认值json

有效值:

  • json— 输出格式化为字符JSON串。

  • yaml— 输出格式化为字符YAML串。

  • yaml-stream— 输出被流式传输并格式化为YAML字符串。串流支持更快地处理大型数据类型。

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

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

parameter_validation-共享 AWS config文件设置

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

默认值true

有效值:

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

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

兼容 AWS SDKs

以下内容SDKs支持本主题中描述的功能和设置。所有部分例外情况均已注明。支持任何JVM系统属性设置 AWS SDK for Java 还有 AWS SDK for Kotlin 只有。

SDK 支持 备注或更多信息
AWS CLI v2 部分 api_versions 不支持。
SDK对于 C++
SDK适用于 Go V2 (1.x) 部分 不支持 api_versionsparameter_validation
SDK适用于 Go 1.x (V1) 部分 不支持 api_versionsparameter_validation。要使用共享 config 文件设置,必须开启从配置文件加载的功能;请参阅会话
SDK适用于 Java 2.x
SDK适用于 Java 1.x
SDK适用于 JavaScript 3.x
SDK适用于 JavaScript 2.x
SDK对于 Kotlin 来说
SDK对于。 NET3.x
SDK适用于 PHP 3.x
SDK适用于 Python (Boto3)
SDK适用于 Ruby 3.x
SDK对于 Rust
SDK为斯威夫特
用于 PowerShell