AWS SDK for Ruby でのサービスクライアントの設定 - AWS SDK for Ruby

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS SDK for Ruby でのサービスクライアントの設定

AWS のサービスにプログラムでアクセスするために、AWS SDK for Ruby では各 AWS のサービスに対してクライアントクラスを使用します。たとえば、アプリケーションが Amazon EC2 にアクセスする必要がある場合、アプリケーションはそのサービスとインターフェイスをとる Amazon EC2 クライアントオブジェクトを作成します。次に、サービスクライアントを使用して、その AWS のサービス に対してリクエストを実行します。

AWS のサービス にリクエストを行うには、まずサービスクライアントを作成する必要があります。コードが使用する各 AWS のサービス には、それぞれ独自の gem と、サービスとやり取りするための専用の型があります。クライアントは、サービスが提供する各 API オペレーションに対応するメソッドをそれぞれ公開しています。

SDK の動作を設定する方法は多岐にわたりますが、最終的にはすべてサービスクライアントの動作に関係しています。どのような設定も、それに基づいて作成されたサービスクライアントが使用されるまでは効果がありません。

AWS のサービス を使用して開発する際には、AWS によりコードがどのように認証するかを確立する必要があります。使用する AWS リージョン を設定する必要があります。

AWS SDK とツールのリファレンスガイドには、AWS SDK の多くに共通する設定、機能、その他の基本概念も含まれています。

共有ファイル configcredentials ファイルは、設定に使用できます。すべての AWS SDK 設定については、「AWS SDK およびツールリファレンスガイド」の「設定リファレンス」を参照してください。

異なるプロファイルを使用して、異なる設定を保存できます。AWS_PROFILE 環境変数または Aws.configprofile オプションを使用して、SDK がロードするアクティブプロファイルを指定できます。

設定の優先順位

グローバル設定は、ほとんどの SDK でサポートされ、AWS のサービス 全体に幅広く影響する機能、認証情報プロバイダー、およびその他の機能を設定します。すべての AWS SDK には、グローバル設定の値を見つけるための一連の場所 (またはソース) があります。すべての設定がすべてのソースで使用できるわけではありません。設定検索の優先順位は次のとおりです。

  1. コードまたはサービスクライアント自体に設定されている明示的な設定は、他の設定よりも優先されます。

    1. クライアントコンストラクタに直接渡されるパラメータが最も優先されます。

    2. Aws.config は、グローバル設定またはサービス固有の設定をチェックします。

  2. 環境変数が確認されます。

  3. 共有 AWS credentials ファイルがチェックされます。

  4. 共有 AWS config ファイルがチェックされます。

  5. AWS SDK for Ruby のソースコード自体が提供するデフォルト値が最後に使用されます。