翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS リージョン
AWS リージョン は、 を使用する際に理解しておくべき重要な概念です AWS のサービス。
を使用すると AWS リージョン、特定の地理的エリアに AWS のサービス 物理的に存在する にアクセスできます。これは、ユーザーがアクセスする場所の近くでのデータとアプリケーションの実行を維持するために有効です。リージョンでは耐障害性や安定性が提供され、レイテンシーを低減することもできます。これにより、リージョンの障害の影響を受けずに利用できる冗長リソースを作成できます。
ほとんどの AWS のサービス リクエストは、特定の地理的リージョンに関連付けられています。あるリージョンで作成したリソースは、 AWS のサービスで提供されるレプリケーション機能を明示的に使用しないかぎり、他のリージョンに存在することはありません。例えば、Amazon S3 と Amazon はクロスリージョンレプリケーションEC2をサポートしています。などの一部のサービスにはIAM、リージョンリソースがありません。
AWS 全般のリファレンス には、以下の情報が含まれています。
-
リージョンとエンドポイントの関係を理解し、既存のリージョンエンドポイントのリストを表示するには、「AWS サービスエンドポイント」 を参照してください。
-
各 AWS のサービスでサポートされているすべてのリージョンおよびエンドポイントの現在のリストを確認する方法については、の「サービスとエンドポイントの割り当て」を参照してください。
サービスクライアントの作成
にプログラムでアクセスするには AWS のサービス、各 にクライアントクラス/オブジェクトSDKsを使用します AWS のサービス。例えばEC2、アプリケーションが Amazon にアクセスする必要がある場合、アプリケーションはそのサービスとインターフェイスする Amazon EC2クライアントオブジェクトを作成します。
コード自体でクライアントにリージョンが明示的に指定されていない場合、クライアントはデフォルトで、次のregion設定で設定されたリージョンを使用します。ただし、クライアントのアクティブリージョンは個々のクライアントオブジェクトに明示的に設定できます。この方法でのリージョンの設定は、特定のサービスクライアントのグローバル設定よりも優先されます。代替リージョンは、 に固有の、そのクライアントのインスタンス化中に指定されます SDK (特定のSDKガイドまたは SDKのコードベースを確認してください）。
この機能を設定するには、以下のように使用します。
region- 共有 AWSconfigファイル設定AWS_REGION- 環境変数aws.region- JVMシステムプロパティ: Java/Kotlin のみ-
AWS リクエスト AWS リージョン に使用するデフォルトを指定します。このリージョンは、使用する特定のリージョンで指定されていないSDKサービスリクエストに使用されます。
デフォルト値： なし。この値は明示的に指定する必要があります。
有効な値:
-
「AWS 全般リファレンス」の「AWS サービスエンドポイント」に記載されているように、選択したサービスで使用できるどのリージョンコードでも指定できます。たとえば、この
us-east-1値により、エンドポイントは AWS リージョン 米国東部 (バージニア北部)に設定されます。 -
aws-globalは、 AWS Security Token Service （AWS STS) や Amazon Simple Storage Service (Amazon S3) などのリージョンエンドポイントに加えて、別のグローバルエンドポイントをサポートするサービスのグローバルエンドポイントを指定します。
-
config ファイルにこの値を設定する例を以下に示します。
[default] region = us-west-2
Linux/macOS のコマンドラインによる環境変数の設定の例を以下に示します。
export AWS_REGION=us-west-2
Windows のコマンドラインによる環境変数の設定の例を以下に示します。
setx AWS_REGION us-west-2
ほとんどの SDKs には、アプリケーションコード内からデフォルトのリージョンを設定できる「設定」オブジェクトがあります。詳細については、特定の AWS SDKデベロッパーガイドを参照してください。
との互換性 AWS SDKs
このトピックで説明されている機能と設定SDKsを以下に示します。部分的な例外があれば、すべて記載されています。すべてのJVMシステムプロパティ設定は、 AWS SDK for Java と AWS SDK for Kotlin のみがサポートします。
| SDK | サポート | 注意または詳細情報 |
|---|---|---|
| AWS CLI v2 | はい | AWS CLI v2 は、 の値AWS_REGIONの前に の値を使用します AWS_DEFAULT_REGION (両方の変数がチェックされます）。 |
| AWS CLI v1 | はい | AWS CLI v1 はこの目的のために というAWS_DEFAULT_REGION名前の環境変数を使用します。 |
| SDK C++ 用 | はい | |
| SDK Go V2 用 (1.x) |
はい | |
| SDK Go 1.x (V1) の場合 | はい | 共有 config ファイル設定を使用するには、設定ファイルからの読み込みを有効にする必要があります。「セッション」を参照してください。 |
| SDK Java 2.x 用 | はい | |
| SDK Java 1.x 用 | はい | |
| SDK JavaScript 3.x の場合 | はい | |
| SDK JavaScript 2.x の場合 | はい | |
| SDK Kotlin の場合 | はい | |
| SDK の 。NET 3.x | はい | |
| SDK 3.x PHP の場合 | はい | |
| SDK Python 用 (Boto3) |
はい | これは、この目的のために というAWS_DEFAULT_REGION名前の環境変数SDKを使用します。 |
| SDK Ruby 3.x 用 | はい | |
| SDK Rust の場合 | はい | |
| SDK Swift の場合 | はい | |
| のツール PowerShell | はい |
