在適用於 Ruby 的 AWS SDK 中設定服務用戶端 - AWS 適用於 Ruby 的 SDK

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

在適用於 Ruby 的 AWS SDK 中設定服務用戶端

若要以程式設計方式存取 AWS 服務,適用於 Ruby 的 AWS SDK 會針對每個 使用用戶端類別 AWS 服務。例如,如果您的應用程式需要存取 Amazon EC2,您的應用程式會建立 Amazon EC2 用戶端物件以與該服務連接。然後,您可以使用 服務用戶端向該用戶端提出請求 AWS 服務。

若要向 提出請求 AWS 服務,您必須先建立服務用戶端。對於 AWS 服務 您的程式碼使用的每個 ,它都有自己的 Gem 套件和自己的專用類型來與其互動。用戶端會針對服務公開的每個 API 操作公開一個方法。

設定 SDK 行為有許多替代方法,但最終一切都與服務用戶端的行為有關。使用從中建立的服務用戶端之前,任何組態都不會生效。

當您使用 開發 AWS 時,您必須建立程式碼向 進行身分驗證的方式 AWS 服務。您也必須設定 AWS 區域 要使用的 。

AWS SDKs和工具參考指南也包含許多 AWS SDKs 中常見的設定、功能和其他基本概念。

共用 configcredentials 檔案可用於組態設定。如需所有 AWS SDK 設定,請參閱 SDK 和工具參考指南中的設定參考。 AWS SDKs

不同的設定檔可用來存放不同的組態。若要指定 SDK 載入的作用中設定檔,您可以使用 AWS_PROFILE環境變數或 profile的選項Aws.config

設定的優先順序

全域設定可設定大多數 SDKs 支援且具有廣泛影響的功能、登入資料提供者和其他功能 AWS 服務。 AWS SDKs有一系列要檢查的位置 (或來源),以尋找全域設定的值。並非所有設定都可在所有來源中使用。以下是設定查詢優先順序:

  1. 程式碼中或服務用戶端本身上設定的任何明確設定,都優先於任何其他設定。

    1. 直接傳遞至用戶端建構函數的任何參數都具有最高的優先順序。

    2. Aws.config 會檢查全域或服務特定的設定。

  2. 檢查 環境變數。

  3. 已檢查共用 AWS credentials檔案。

  4. 已檢查共用 AWS config檔案。

  5. 適用於 Ruby 的 AWS 開發套件原始碼本身所提供的任何預設值都會最後使用。