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

# 智能配置默认值
<a name="feature-smart-config-defaults"></a>

**注意**  
如需了解设置页面布局或解释后面的 Support b **y AWS SDKs 和 tools** 表格的帮助，请参阅[了解本指南的设置页面](settings-reference.md#settingsPages)。

借助智能配置默认值功能， AWS SDKs 可以为其他配置设置提供预定义的、优化的默认值。

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

**`defaults_mode`-共享 AWS `config`文件设置`AWS_DEFAULTS_MODE` - 环境变量`aws.defaultsMode`-JVM 系统属性：仅限 Java/Kotlin **  
使用此设置，您可以选择与您的应用程序架构相匹配的模式，然后为您的应用程序提供经过优化的默认值。如果 S AWS DK 设置明确设置了值，则该值始终优先。如果 S AWS DK 设置没有明确设置值，并且`defaults_mode`不等于旧版，则此功能可以为针对您的应用程序优化的各种设置提供不同的默认值。设置可能包括以下内容：HTTP 通信设置、重试行为、服务区域端点设置，可能还包括任何与 SDK 相关的配置。使用此功能的客户可以获得针对常见使用场景量身定制的新配置默认值。由于提供的默认值可能会随着最佳实践的发展而改变，因此如果您的 `defaults_mode` 不等于 `legacy`，我们建议您在升级 SDK 时对您的应用程序进行测试。  
**默认值**：`legacy`  
注意：will 的新主要 SDKs 版本默认为`standard`。  
**有效值：**  
+ `legacy` – 提供默认设置，这些设置因 SDK 而异，并且在建立 `defaults_mode` 之前就已存在。
+ `standard` – 提供最新的推荐默认值，这些默认值在大多数情况下都应该可以安全运行。
+ `in-region`— 基于标准模式构建，包括为 AWS 服务 从标准模式内部调用的应用程序量身定制的优化 AWS 区域。
+ `cross-region`— 基于标准模式构建，包括为调用不同区域的应用程序量身定制 AWS 服务 的优化。
+ `mobile` – 基于标准模式构建，包括为移动应用程序量身定制的优化。
+ `auto` – 基于标准模式构建，包括实验功能。SDK 会尝试发现运行时系统环境以自动确定适当的设置。自动检测是基于启发式的，无法提供 100% 的准确性。如果无法确定运行时系统环境，则使用 `standard` 模式。自动检测功能可能会查询[实例元数据](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)，这可能会带来延迟。如果启动延迟对您的应用程序而言至关重要，我们建议您改为选择显式 `defaults_mode` 延迟。
 在 `config` 文件中设置此值的示例：  

```
[default]
defaults_mode = standard
```
以下参数可能会根据 `defaults_mode` 的选项进行优化：  
+ `retryMode` – 指定 SDK 如何尝试重试。请参阅[重试行为](feature-retry-behavior.md)。
+ `stsRegionalEndpoints`— 指定 SDK 如何确定用于与 AWS Security Token Service (AWS STS) 通信的 AWS 服务 端点。请参阅[AWS STS 区域终端节点](feature-sts-regionalized-endpoints.md)。
+ `s3UsEast1RegionalEndpoints`— 指定软件开发工具包如何确定用于与该`us-east-1`区域的 Amazon S3 通信的 AWS 服务终端节点。
+ `connectTimeoutInMillis` – 在套接字上进行初始连接尝试后，超时之前的时长。如果客户端没有收到连接握手完成的消息，则客户端会放弃操作并使其失败。
+ `tlsNegotiationTimeoutInMillis` – 从发送 CLIENT HELLO 消息到客户端和服务器完全协商密码并交换密钥，TLS 握手可能花费的最大时长。

每个设置的默认值会根据为应用程序选择的 `defaults_mode` 而变化。这些值目前设置如下（可能会发生变化）：


| 参数 | `standard` 模式 | `in-region` 模式 | `cross-region` 模式 | `mobile` 模式 | 
| --- | --- | --- | --- | --- | 
|  retryMode  | standard | standard | standard | standard | 
|  stsRegionalEndpoints  | regional | regional | regional | regional | 
|  s3UsEast1RegionalEndpoints  | regional | regional | regional | regional | 
|  connectTimeoutInMillis  | 3100 | 1100 | 3100 | 30000 | 
|  tlsNegotiationTimeoutInMillis  | 3100 | 1100 | 3100 | 30000 | 

例如，如果您选择的`defaults_mode`是`standard`，则将为`retry_mode`分配`standard`的值（来自有效的`retry_mode`选项），将为`stsRegionalEndpoints`分配`regional`的值（来自有效`stsRegionalEndpoints`选项）。

## Support AWS SDKs by 和工具
<a name="feature-smart-config-defaults-sdk-compat"></a>

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


| SDK | 支持 | 备注或更多信息 | 
| --- | --- | --- | 
| [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | 否 |  | 
| [适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) |  是 | 参数未优化：stsRegionalEndpoints、s3UsEast1RegionalEndpoints、tlsNegotiationTimeoutInMillis。 | 
| [适用于 Go V2 (1.x) 的 SDK](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | 是 | 参数未优化：retryMode、stsRegionalEndpoints、s3UsEast1RegionalEndpoints。 | 
| [适用于 Go 1.x（V1）的 SDK](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | 否 |  | 
| [适用于 Java 2.x 的 SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | 是 | 参数未优化：stsRegionalEndpoints。 | 
| [适用于 Java 1.x 的 SDK](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | 否 |  | 
| [适用于 JavaScript 3.x 的软件开发工具包](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | 是 | 参数未优化：stsRegionalEndpoints、s3UsEast1RegionalEndpoints、tlsNegotiationTimeoutInMillis。connectTimeoutInMillis 被称为 connectionTimeout。 | 
| [适用于 JavaScript 2.x 的 SDK](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | 否 |  | 
| [适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | 否 |  | 
| [适用于.NET 4.x 的 SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | 是 | 参数未优化：connectTimeoutInMillis、tlsNegotiationTimeoutInMillis。 | 
| [适用于 .NET 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | 是 | 参数未优化：connectTimeoutInMillis、tlsNegotiationTimeoutInMillis。 | 
| [适用于 PHP 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | 是 | 参数未优化：tlsNegotiationTimeoutInMillis。 | 
| [适用于 Python (Boto3) 的 SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | 是 | 参数未优化：tlsNegotiationTimeoutInMillis。 | 
| [适用于 Ruby 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | 是 |   | 
| [适用于 Rust 的 SDK](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | 否 |  | 
| [适用于 Swift 的 SDK](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | 否 |  | 
| [适用于 PowerShell V5 的工具](https://docs.aws.amazon.com/powershell/latest/userguide/) | 是 | 参数未优化：connectTimeoutInMillis、tlsNegotiationTimeoutInMillis。 | 
| [适用于 PowerShell V4 的工具](https://docs.aws.amazon.com/powershell/v4/userguide/) | 是 | 参数未优化：connectTimeoutInMillis、tlsNegotiationTimeoutInMillis。 |