本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
常规配置设置
SDKs支持一些用于配置整体SDK行为的常规设置。
使用以下方法配置此功能:
api_versions
-共享 AWSconfig
文件设置-
一段时间 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
-共享 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.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
-共享 AWSconfig
文件设置-
指定结果的格式化方式 AWS CLI 和其他 AWS SDKs和工具。
默认值:
json
有效值:
parameter_validation
-共享 AWSconfig
文件设置-
指定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_versions 和 parameter_validation 。 |
SDK适用于 Go 1.x (V1) | 部分 | 不支持 api_versions 和 parameter_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 | 否 |