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