使用適用於 Ruby 的 AWS SDK 提出 AWS 服務 請求 - AWS 適用於 Ruby 的 SDK

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

使用適用於 Ruby 的 AWS SDK 提出 AWS 服務 請求

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

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

每個服務用戶端都需要 AWS 區域 和登入資料提供者。SDK 使用這些值將請求傳送到 資源的正確區域，並使用正確的登入資料簽署請求。您可以在程式碼中以程式設計方式指定這些值，或從環境自動載入這些值。

  • 執行個體化用戶端類別時，必須提供 AWS 憑證。如需 SDK 檢查身分驗證提供者的順序，請參閱 登入資料提供者鏈結。

  • 開發套件有一系列位置 （或來源） 可供其檢查，以尋找組態設定的值。如需詳細資訊，請參閱設定的優先順序。

適用於 Ruby 的 SDK 包含提供 界面的用戶端類別 AWS 服務。每個用戶端類別都支援特定 AWS 服務 ，並遵循慣例 Aws::<service identifier>::Client。例如， Aws::S3::Client 提供 Amazon Simple Storage Service 服務的界面，Aws::SQS::Client並提供 Amazon Simple Queue Service 服務的界面。

所有 的所有用戶端類別 AWS 服務 都是執行緒安全的。

您可以直接將組態選項傳遞給用戶端和資源建構函式。這些選項優先於環境和Aws.config預設值。

# using a credentials object
ec2 = Aws::EC2::Client.new(region: 'us-west-2', credentials: credentials)