智能配置默认值

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

defaults_mode-共享 Amazon config文件设置

AWS_DEFAULTS_MODE - 环境变量

aws.defaultsMode-JVM 系统属性：仅限 Java/Kotlin

使用此设置，您可以选择与您的应用程序架构相匹配的模式，然后为您的应用程序提供经过优化的默认值。如果 S Amazon DK 设置明确设置了值，则该值始终优先。如果 S Amazon DK 设置没有明确设置值，并且defaults_mode不等于旧版，则此功能可以为针对您的应用程序优化的各种设置提供不同的默认值。设置可能包括以下内容：HTTP 通信设置、重试行为、服务区域端点设置，可能还包括任何与 SDK 相关的配置。使用此功能的客户可以获得针对常见使用场景量身定制的新配置默认值。由于提供的默认值可能会随着最佳实践的发展而改变，因此如果您的 defaults_mode 不等于 legacy，我们建议您在升级 SDK 时对您的应用程序进行测试。

默认值：legacy

注意：SDK 的新主要版本将默认为standard。

有效值：

• legacy – 提供默认设置，这些设置因 SDK 而异，并且在建立 defaults_mode 之前就已存在。

• standard – 提供最新的推荐默认值，这些默认值在大多数情况下都应该可以安全运行。

• in-region— 基于标准模式构建，包括为 Amazon Web Services 从标准模式内部调用的应用程序量身定制的优化 Amazon Web Services 区域。

• cross-region— 基于标准模式构建，包括为调用不同区域的应用程序量身定制 Amazon Web Services 的优化。

• mobile – 基于标准模式构建，包括为移动应用程序量身定制的优化。

• auto – 基于标准模式构建，包括实验功能。SDK 会尝试发现运行时系统环境以自动确定适当的设置。自动检测是基于启发式的，无法提供 100% 的准确性。如果无法确定运行时系统环境，则使用 standard 模式。自动检测可能会查询实例元数据和用户数据，这可能会带来延迟。如果启动延迟对您的应用程序而言至关重要，我们建议您改为选择显式 defaults_mode 延迟。

在 config 文件中设置此值的示例：

[default]
defaults_mode = standard

以下参数可能会根据 defaults_mode 的选项进行优化：

• retryMode – 指定 SDK 如何尝试重试。请参阅 重试行为。

• stsRegionalEndpoints— 指定 SDK 如何确定用于与 Amazon Security Token Service (Amazon STS) 通信的 Amazon Web Service 端点。请参阅 Amazon STS 区域化终端节点。

• s3UsEast1RegionalEndpoints— 指定软件开发工具包如何确定用于与该us-east-1区域的 Amazon S3 通信的 Amazon 服务终端节点。

• connectTimeoutInMillis – 在套接字上进行初始连接尝试后，超时之前的时长。如果客户端没有收到连接握手完成的消息，则客户端会放弃操作并使其失败。

• tlsNegotiationTimeoutInMillis – 从发送 CLIENT HELLO 消息到客户端和服务器完全协商密码并交换密钥，TLS 握手可能花费的最大时长。