选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

常规配置设置 - AWS SDKs 和工具

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

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

常规配置设置

注意

如需了解设置页面布局或解释后面的 Support b y AWS SDKs 和 tools 表格的帮助,请参阅了解本指南的设置页面

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

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

api_versions-共享 AWS config文件设置

有些 AWS 服务维护多个 API 版本以支持向后兼容。默认情况下,SDK 和 AWS CLI 操作使用最新的可用 API 版本。如要求使用特定的 API 版本来处理您的请求,请在您的个人资料中添加该 api_versions 设置。

默认值:无。(SDK 使用的最新 API 版本。)

有效值:这是一个嵌套设置,后面有一行或多行缩进,每行标识一项 AWS 服务和要使用的 API 版本。要了解有哪些 API 版本可用,请参阅该 AWS 服务的文档。

该示例为config文件中的两个 AWS 服务设置了特定的 API 版本。这些 API 版本仅用于在包含这些设置的配置文件下运行的命令。任何其他服务的命令都使用该服务的 API 的最新版本。

api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
ca_bundle-共享 AWS 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-共享 AWS config文件设置

指定如何在 AWS CLI 和其他工具中设置结果 AWS SDKs 的格式。

默认值json

有效值:

  • json – 输出采用 JSON 字符串的格式。

  • yaml – 输出采用 YAML 字符串的格式。

  • yaml-stream – 输出被流式处理并采用 YAML 字符串的格式。串流支持更快地处理大型数据类型。

  • text – 输出采用多个制表符分隔字符串值行的格式。这对于将输出传递到文本处理器(如 grepsedawk)很有用。

  • table – 输出采用表格形式,使用字符 +|- 以形成单元格边框。它通常以“人性化”格式呈现信息,这种格式比其他格式更容易阅读,但从编程方面来讲不是那么有用。

parameter_validation-共享 AWS config文件设置

指定 SDK 或工具在将命令行参数发送到 AWS 服务端点之前是否尝试验证这些参数。

默认值true

有效值:

  • true – 默认值。SDK 或工具执行命令行参数的客户端验证。这有助于 SDK 或工具确认参数是否有效,并捕获一些错误。SDK 或工具可以在向 AWS 服务端点发送请求之前拒绝无效的请求。

  • false— SDK 或工具在将命令行参数发送到 AWS 服务端点之前不会对其进行验证。 AWS 服务端点负责验证所有请求并拒绝无效的请求。

Support AWS SDKs by 和工具

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

SDK 支持 备注或更多信息
AWS CLI v2 部分 api_versions 不支持。
适用于 C++ 的 SDK
适用于 Go V2 (1.x) 的 SDK 部分 不支持 api_versionsparameter_validation
适用于 Go 1.x(V1)的 SDK 部分 不支持 api_versionsparameter_validation。要使用共享 config 文件设置,必须开启从配置文件加载的功能;请参阅会话
适用于 Java 2.x 的 SDK
适用于 Java 1.x 的 SDK
适用于 JavaScript 3.x 的软件开发工具包
适用于 JavaScript 2.x 的 SDK
适用于 Kotlin 的 SDK
适用于 .NET 3.x 的 SDK
适用于 PHP 3.x 的 SDK
适用于 Python (Boto3) 的 SDK
适用于 Ruby 3.x 的 SDK
适用于 Rust 的 SDK
适用于 Swift 的 SDK
用于 PowerShell

下一主题:

IMDS 客户端

上一主题:

端点发现
隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。