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

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

設定がコード内で直接処理される場合、設定のスコープは、そのコードを使用するアプリケーションに限定されます。そのアプリケーション内には、すべてのサービスクライアントに対するグローバル設定、特定の AWS のサービス タイプのすべてのクライアントに対する設定、特定のサービスクライアントインスタンスに対する設定のオプションがあります。

Aws.config

すべてのAWS クラスのコード内でグローバル設定を指定するには、aws-sdk-core gem で利用可能な Aws.config を使用します。

Aws.config は、さまざまな用途に備えて 2 つの構文をサポートします。グローバル設定は、すべての AWS のサービスにも特定のサービスにも適用できます。サポートされているすべての設定が記載されているリストについては、「AWS SDK for Ruby API リファレンス」の「Client Options」を参照してください。

Aws.config によるグローバル設定

Aws.config を使用して、サービスに依存しない設定を行うには、次の構文を使用します。

Aws.config[:<global setting name>] = <value>

これらの設定は、作成されたサービスクライアントにマージされます。

グローバル設定の例:

Aws.config[:region] = 'us-west-2'

グローバルにサポートされない設定名を使用しようした場合、サポートされていないタイプのサービスのインスタンスを作成しようとしたときにエラーが発生します。この場合、サービス固有の構文が代わりに使用されます。

Aws.config によるサービス固有の設定

Aws.config を使用してサービス固有の設定を行うには、次の構文を使用します。

Aws.config[:<service identifier>] = { <global setting name>: <value> }

これらの設定は、そのサービスタイプの、作成されたすべてのサービスクライアントにマージされます。

Amazon S3 にのみ適用される設定の例:

 Aws.config[:s3] = { force_path_style: true }

<service identifier> は、対応する AWS SDK for Ruby gem 名の名前を確認して「aws-sdk-」の後に続くサフィックスを使用すると特定できます。例: