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

AWS SDK for Ruby の AWS リージョンの設定

AWS リージョン を使用して、特定の地理的エリアで動作する AWS のサービス にアクセスできます。これは、冗長性を確保するためや、ユーザーがアクセスする場所の近くでのデータとアプリケーションの実行を維持するために有効です。

AWS リクエストに使用するために、SDK for Ruby 向けのデフォルトの AWS リージョンを設定する必要があります。このデフォルトは、リージョンが指定されていないすべての SDK サービスメソッドの呼び出しに使用されます。

region設定の詳細については、『AWS SDK とツールのリファレンスガイド』の「AWS リージョン」を参照のこと。これには、共有 AWS config ファイルまたは環境変数を使用してデフォルトのリージョンを設定する方法の例も含まれています。

解決のためのリージョン検索順序

AWS のサービスのほとんどのサービスでは、使用時にリージョンを設定する必要があります。AWS SDK for Ruby は、次の手順でリージョンを検索します。

リージョンの設定方法

このセクションでは、リージョン設定について、最も一般的な方法とその他のさまざまな方法を説明します。

共有 config ファイルでリージョンを設定する。

共有 AWSconfig ファイル内の region 変数を設定してリージョンを設定します。共有configファイルの使用についての詳細は、「「AWSSDK とツールのリファレンスガイド」の「共有設定ファイルおよび認証情報ファイル」を参照してください。

config ファイルにこの値を設定する例を以下に示します。

[default]
region = us-west-2

AWS_SDK_CONFIG_OPT_OUT環境変数が設定されている場合、共有configファイルはチェックされません。

環境変数でリージョンを設定する

AWS_REGION 環境変数を設定して、リージョンを設定します。

Linux または macOS のような Unix ベースのシステムでは、export コマンドでこの変数を設定します。次の例では、リージョンを us-west-2 に設定します。

export AWS_REGION=us-west-2

Windows でこれらの変数を設定するには、set コマンドを使用します。次の例では、リージョンを us-west-2 に設定します。

set AWS_REGION=us-west-2

Aws.config でのリージョンの設定

region 値を Aws.config ハッシュに追加してリージョンを設定します。次の例は Aws.config ハッシュを更新して us-west-1 リージョンを使用します。

Aws.config.update({region: 'us-west-1'})

以後に作成するすべてのクライアントやリソースは、このリージョンにバインドされます。

クライアントまたはリソースオブジェクト内でのリージョンの設定

AWS クライアントまたはリソースを作成するときにリージョンを設定します。次の例では、us-west-1 リージョンに Amazon S3 リソースオブジェクトを作成します。AWSリソースに適したリージョンを選択します。サービスクライアントオブジェクトはイミュータブルであるため、リクエストを実行する各サービスについて、または異なった設定を使用する同じサービスにリクエストを実行するために、新しいクライアントを作成する必要があります。

s3 = Aws::S3::Resource.new(region: 'us-west-1')