翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS SDK for Ruby を使用した AWS のサービス リクエストの実行
AWS のサービスにプログラムでアクセスするために、SDK では各 AWS のサービスに対してクライアントクラスを使用します。たとえば、アプリケーションが Amazon EC2 にアクセスする必要がある場合、アプリケーションはそのサービスとインターフェイスをとる Amazon EC2 クライアントオブジェクトを作成します。次に、サービスクライアントを使用して、その AWS のサービス に対してリクエストを実行します。
AWS のサービス にリクエストを行うには、まずサービスクライアントを作成して設定する必要があります。コードが使用する各 AWS のサービス には、それぞれ独自の gem と、サービスとやり取りするための専用の型があります。クライアントは、サービスが提供する各 API オペレーションに対応するメソッドをそれぞれ公開しています。
各サービスクライアントには AWS リージョン と認証情報プロバイダーが必要です。SDK はこれらの値を使用して、リソースの正しいリージョンにリクエストを送信し、正しい認証情報でリクエストに署名します。これらの値はコード内でプログラムで指定することも、環境から自動的にロードされるようにすることもできます。
-
クライアントクラスをインスタンス化する際には、AWS の認証情報を指定する必要があります。SDK が認証プロバイダーをチェックする順序については、「認証情報プロバイダーチェーン」を参照してください。
-
SDK には、設定の値を見つけるために順番に確認する一連の場所 (またはソース) があります。詳細については、「設定の優先順位」を参照してください。
SDK for Ruby には、AWS のサービス へのインターフェイスを提供するクライアントクラスが含まれています。各クライアントクラスは特定の AWS のサービスをサポートし、Aws:: の規則に従います。例えば、<service identifier>::ClientAws::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)
