常规配置设置
注意
如需获得相关帮助,以了解设置页面的布局或解释后面的 AWS SDK 和工具支持表,请参阅了解本指南的设置页面。
SDK 支持一些用于配置 SDK 整体性能的常规设置。
使用以下方法配置此功能:
api_versions- 共享 AWSconfig文件设置-
某些 AWS 服务维护多个 API 版本以支持向后兼容性。默认情况下,SDK 和 AWS CLI 操作使用最新的可用 API 版本。如要求使用特定的 API 版本来处理您的请求,请在您的个人资料中添加该
api_versions设置。默认值:无。(SDK 使用的最新 API 版本。)
有效值:这是一个嵌套设置,后跟一个或多个缩进行,每行标识一个 AWS 服务和要使用的 API 版本。请参阅 AWS 服务的文档以了解可用的 API 版本。
该示例为
config文件中的两个 AWS 服务设置了特定的 API 版本。这些 API 版本仅用于在包含这些设置的配置文件下运行的命令。任何其他服务的命令都使用该服务的 API 的最新版本。api_versions = ec2 =2015-03-01cloudfront =2015-09-017 ca_bundle- 共享 AWSconfig文件设置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.pemLinux/macOS 通过命令行设置环境变量的示例:
export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pemWindows 通过命令行设置环境变量的示例:
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output- 共享AWSconfig文件设置-
指定结果在 AWS CLI 以及其他 AWS SDK 和工具中的格式设置。
默认值:
json有效值:
parameter_validation- 共享 AWSconfig文件设置-
指定 SDK 或工具在将命令行参数发送到 AWS 服务端点之前是否尝试验证这些参数。
默认值:
true有效值:
-
true– 默认值。SDK 或工具执行命令行参数的客户端验证。这有助于 SDK 或工具确认参数是否有效,并捕获一些错误。在向 AWS 服务端点发送请求之前,SDK 或工具可以拒绝无效的请求。 -
false– SDK 或工具在将命令行参数发送到 AWS 服务端点之前不验证这些参数。AWS 服务端点负责验证所有请求并拒绝无效的请求。
-
AWS SDK 和工具支持
以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。任何 JVM 系统属性设置都仅支持 适用于 Java 的 AWS SDK 和 适用于 Kotlin 的 AWS SDK。
| SDK | 支持 | 备注或更多信息 |
|---|---|---|
| AWS CLI v2 | 部分 | api_versions 不支持。 |
| 适用于 C++ 的 SDK | 是 | |
| 适用于 Go V2 (1.x) 的 SDK |
部分 | 不支持 api_versions 和 parameter_validation。 |
| 适用于 Go 1.x(V1)的 SDK | 部分 | 不支持 api_versions 和 parameter_validation。要使用共享 config 文件设置,必须开启从配置文件加载的功能;请参阅会话。 |
| 适用于 Java 2.x 的 SDK | 否 | |
| 适用于 Java 1.x 的 SDK | 否 | |
| 适用于 JavaScript 3.x 的 SDK | 是 | |
| 适用于 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 | 否 | |
| Tools for PowerShell V5 | 否 | |
| Tools for PowerShell V4 | 否 |