在 Amazon SDK for Ruby 中配置服务客户端 - Amazon 适用于 Ruby 的 SDK
设置的优先级
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

在 Amazon SDK for Ruby 中配置服务客户端

为了以编程方式进行访问 Amazon Web Services 服务，适用于 Ruby 的 Amazon SDK 为每个 Amazon Web Services 服务版本使用一个客户端类。例如，如果您的应用程序需要访问亚马逊 EC2，则您的应用程序会创建一个 Amazon EC2 客户端对象来与该服务接口。然后，您可以使用服务客户端向该 Amazon Web Services 服务发出请求。

要向发出请求 Amazon Web Services 服务，必须先创建服务客户端。对于 Amazon Web Services 服务 你使用的每一个代码，它都有自己的 gem 和用于与之交互的专用类型。客户端为服务公开的每个 API 操作公开一种方法。

有许多其他方法可以配置 SDK 行为，但归根结底，一切都与服务客户端的行为有关。在使用基于配置创建的服务客户端之前，任何配置都不会生效。

使用开发 Amazon 时，您必须确定您的代码是如何进行身份验证的。 Amazon Web Services 服务您还必须设置 Amazon Web Services 区域 要使用的。

《Amazon SDKs 和工具参考指南》还包含设置、功能和其他常见的基本概念。 Amazon SDKs

主题

共享config和credentials文件可用于配置设置。有关所有 Amazon SDK 设置，请参阅Amazon SDKs 和工具参考指南中的设置参考。

不同的配置文件可用于存储不同的配置。要指定 SDK 加载的活动配置文件，您可以使用AWS_PROFILE环境变量或profile选项Aws.config。

设置的优先级

全局设置配置了大多数 SDKs 人支持并具有广泛 Amazon Web Services 服务影响的功能、凭证提供程序和其他功能。所有地方 Amazon SDKs都有一系列地点（或来源），他们会检查这些地点（或来源），以便找到全局设置的值。并非所有设置在所有来源中都可用。以下是设置查找优先级的方法：

  1. 在代码中或服务客户端本身上设置的任何显式设置均优先于其他任何设置。

    1. 任何直接传递给客户端构造函数的参数都具有最高优先级。

    2. Aws.config已检查全局设置或服务特定设置。

  2. 系统会检查环境变量。

  3. 已检查共享 Amazon credentials文件。

  4. 已检查共享 Amazon config文件。

  5. 最后使用 Amazon SDK for Ruby 源代码本身提供的任何默认值。