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