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

# 常规配置设置
<a name="feature-gen-config"></a>

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

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

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

**`api_versions`-共享 Amazon `config`文件设置**  
有些 Amazon 服务维护多个 API 版本以支持向后兼容。默认情况下，SDK 和 Amazon CLI 操作使用最新的可用 API 版本。如要求使用特定的 API 版本来处理您的请求，请在您的个人资料中添加该 `api_versions` 设置。  
**默认值：**无。（SDK 使用的最新 API 版本。）   
**有效值：**这是一个嵌套设置，后面有一行或多行缩进，每行标识一项 Amazon 服务和要使用的 API 版本。要了解有哪些 API 版本可用，请参阅该 Amazon 服务的文档。  
 该示例为`config`文件中的两个 Amazon 服务设置了特定的 API 版本。这些 API 版本仅用于在包含这些设置的配置文件下运行的命令。任何其他服务的命令都使用该服务的 API 的最新版本。  

```
api_versions =
    ec2 = {{2015-03-01}}
    cloudfront = {{2015-09-017}}
```

**`ca_bundle`-共享 Amazon `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`-共享 Amazon `config`文件设置**  
指定如何在 Amazon CLI 和其他工具中设置结果 Amazon SDKs 的格式。  
**默认值**：`json`  
**有效值：**  
+ **[https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#json-output](https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#json-output)** – 输出采用 [JSON](https://json.org/) 字符串的格式。
+  **[https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#yaml-output](https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#yaml-output)** – 输出采用 [YAML](https://yaml.org/) 字符串的格式。
+ **[https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#yaml-stream-output](https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#yaml-stream-output)** – 输出被流式处理并采用 [YAML](https://yaml.org/) 字符串的格式。串流支持更快地处理大型数据类型。
+ **[https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#text-output](https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#text-output)** – 输出采用多个制表符分隔字符串值行的格式。这对于将输出传递到文本处理器（如 `grep`、`sed` 或 `awk`）很有用。
+ **[https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#table-output](https://docs.amazonaws.cn/cli/latest/userguide/cli-usage-output-format.html#table-output)** – 输出采用表格形式，使用字符 \+\|- 以形成单元格边框。它通常以“人性化”格式呈现信息，这种格式比其他格式更容易阅读，但从编程方面来讲不是那么有用。

**`parameter_validation`-共享 Amazon `config`文件设置**  
指定 SDK 或工具在将命令行参数发送到 Amazon 服务端点之前是否尝试验证这些参数。  
**默认值**：`true`  
**有效值：**  
+ **`true`** – 默认值。SDK 或工具执行命令行参数的客户端验证。这有助于 SDK 或工具确认参数是否有效，并捕获一些错误。在向 Amazon 服务端点发送请求之前，SDK 或工具可以拒绝无效的请求。
+  **`false`**— SDK 或工具在将命令行参数发送到 Amazon 服务端点之前不会对其进行验证。 Amazon 服务端点负责验证所有请求并拒绝无效的请求。

## Support by Amazon SDKs and too
<a name="feature-gen-config-sdk-compat"></a>

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


| SDK | 支持 | 备注或更多信息 | 
| --- | --- | --- | 
| [Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/) v2 | 部分 | api\_versions 不支持。 | 
| [适用于 C\+\+ 的 SDK](https://docs.amazonaws.cn/sdk-for-cpp/latest/developer-guide/) | 是 |  | 
| [适用于 Go V2 (1.x) 的 SDK](https://docs.amazonaws.cn/sdk-for-go/v2/developer-guide/) | 部分 | 不支持 api\_versions 和 parameter\_validation。 | 
| [适用于 Go 1.x（V1）的 SDK](https://docs.amazonaws.cn/sdk-for-go/latest/developer-guide/) | 部分 | 不支持 api\_versions 和 parameter\_validation。要使用共享 config 文件设置，必须开启从配置文件加载的功能；请参阅[会话](https://docs.amazonaws.cn/sdk-for-go/api/aws/session/)。 | 
| [适用于 Java 2.x 的 SDK](https://docs.amazonaws.cn/sdk-for-java/latest/developer-guide/) | 否 |  | 
| [适用于 Java 1.x 的 SDK](https://docs.amazonaws.cn/sdk-for-java/v1/developer-guide/) | 否 |  | 
| [适用于 JavaScript 3.x 的软件开发工具包](https://docs.amazonaws.cn/sdk-for-javascript/latest/developer-guide/) | 是 |  | 
| [适用于 JavaScript 2.x 的 SDK](https://docs.amazonaws.cn/sdk-for-javascript/v2/developer-guide/) | 是 |  | 
| [适用于 Kotlin 的 SDK](https://docs.amazonaws.cn/sdk-for-kotlin/latest/developer-guide/) | 否 |  | 
| [适用于.NET 4.x 的 SDK](https://docs.amazonaws.cn/sdk-for-net/latest/developer-guide/) | 否 |  | 
| [适用于 .NET 3.x 的 SDK](https://docs.amazonaws.cn/sdk-for-net/v3/developer-guide/) | 否 |  | 
| [适用于 PHP 3.x 的 SDK](https://docs.amazonaws.cn/sdk-for-php/latest/developer-guide/) | 是 |  | 
| [适用于 Python (Boto3) 的 SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | 是 |  | 
| [适用于 Ruby 3.x 的 SDK](https://docs.amazonaws.cn/sdk-for-ruby/latest/developer-guide/) | 是 |  | 
| [适用于 Rust 的 SDK](https://docs.amazonaws.cn/sdk-for-rust/latest/dg/) | 否 |  | 
| [适用于 Swift 的 SDK](https://docs.amazonaws.cn/sdk-for-swift/latest/developer-guide/) | 否 |  | 
| [适用于 PowerShell V5 的工具](https://docs.amazonaws.cn/powershell/latest/userguide/) | 否 |  | 
| [适用于 PowerShell V4 的工具](https://docs.amazonaws.cn/powershell/v4/userguide/) | 否 |  |