在外部配置适用于 Ruby 的 Amazon SDK 服务客户端

许多配置设置可以通过代码以外的方式来处理。在外部处理配置时，配置将应用于您的所有应用程序。大多数配置设置可以设置为环境变量，也可以在单独的共享 Amazon config 文件中设置。共享 config 文件可以维护多组独立的设置（称为配置文件），以便为不同的环境或测试提供不同的配置。

环境变量和共享 config 文件设置都已标准化，可在 Amazon SDK 和工具之间共享，从而支持在不同编程语言和应用程序之间保持一致的功能。

请参阅《Amazon SDK 和工具参考指南》，了解如何通过这些方法配置应用程序，以及每个跨 SDK 设置的详细信息。要查看 SDK 可以从环境变量或配置文件中解析的所有设置，请参阅《Amazon SDK 和工具参考指南》中的设置参考。

要向 Amazon Web Services 服务发出请求，请先实例化该服务对应的客户端。您可以为服务客户端配置常用设置，例如超时、HTTP 客户端及重试配置。

每个服务客户端都需要一个 Amazon Web Services 区域和一个凭证提供程序。SDK 使用这些值将您的资源请求发送到正确的区域，并使用正确的凭证对请求进行签名。您可以在代码中以编程方式指定这些值，也可以让它们从环境变量中自动加载。

该 SDK 有一系列地点（或来源），它会检查这些地点（或来源），以便找到配置设置的值。

在代码中或服务客户端本身上设置的任何显式设置均优先于其他任何设置。
环境变量
- 有关设置环境变量的详细信息，请参阅《Amazon SDK 和工具参考指南》中的环境变量。
- 请注意，您可以在不同作用域层级为 shell 配置环境变量：系统级、用户级，以及特定终端会话级。
共享config文件和credentials文件
- 有关设置这些文件的详细信息，请参阅《Amazon SDK 和工具参考指南》中的共享 config 和 credentials 文件。
最后才会使用 SDK 源代码本身提供的任何默认值。
- 某些属性（例如“区域”）没有默认值。您必须在代码、环境设置或共享 config 文件中明确指定这些属性。如果 SDK 无法解析所需的配置，API 请求在运行时会失败。

适用于 Ruby 的 Amazon SDK 环境变量

除了大多数 Amazon SDK 支持的跨 SDK 环境变量外，适用于 Ruby 的 Amazon SDK 还支持一些独特的变量：

AWS_SDK_CONFIG_OPT_OUT: 如果设置了适用于 Ruby 的 Amazon SDK 环境变量 AWS_SDK_CONFIG_OPT_OUT，则共享 Amazon config 文件（通常位于 ~/.aws/config）将不会用于任何配置值。
AMAZON_REGION: 用于设置 Amazon Web Services 区域的 AWS_REGION 替代环境变量。只有在未使用 AWS_REGION 时，才会检查该值。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

配置服务客户端

代码中的客户端配置