AWS STS 地域化されたエンドポイント

デフォルトでは、 AWS Security Token Service (AWS STS) はグローバルサービスとして使用でき、 AWS STS すべてのリクエストはの 1 https://sts.amazonaws.com つのエンドポイントに送信されます。グローバルリクエストは米国東部 (バージニア北部) リージョンにマップされます。 AWS AWS STS グローバルエンドポイントの代わりにリージョナルエンドポイントを使用することを推奨します。 AWS STS エンドポイントの詳細については、API リファレンスの「エンドポイント」AWS Security Token Service を参照してください。

この機能を設定するには、以下のように使用します。

sts_regional_endpoints-共有ファイル設定 AWS config

AWS_STS_REGIONAL_ENDPOINTS - 環境変数

この設定では、SDK またはツールが AWS Security Token Service (AWS STS) AWS のサービス との通信に使用するエンドポイントを決定する方法を指定します。

デフォルト値: legacy

注記

2022 年 7 月以降にリリースされるすべての SDK メジャーバージョンは、デフォルトで regional に設定されます。新しい SDK メジャーバージョンでは、この設定が削除され、regional 動作が使用する可能性があります。この変更による将来的な影響を減らすため、可能な場合はアプリケーションで regional の使用を開始することをお勧めします。

有効な値： (推奨値：regional)

• legacy—,,,,,sts.amazonaws.com,,,,ap-northeast-1,,,,ap-south-1,ap-southeast-1,ap-southeast-2,aws-global,ca-central-1,eu-central-1,eu-north-1, eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-east-2us-west-1, AWS STS AWS およびの各リージョンのグローバルエンドポイントを使用しますus-west-2。他のすべてのリージョンでは、それぞれのリージョンエンドポイントが自動的に使用されます。

• regional— SDK またはツールは常に、 AWS STS 現在設定されているリージョンのエンドポイントを使用します。たとえば、クライアントが使用するように設定されている場合us-west-2、 AWS STS sts.us-west-2.amazonaws.comsts.amazonaws.comへの呼び出しはすべてグローバルエンドポイントではなくリージョナルエンドポイントに対して行われます。この設定が有効なときにグローバルエンドポイントにリクエストを送信するには、リージョンを aws-global に設定します。

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

[default]
sts_regional_endpoints = regional

Linux/macOS のコマンドラインによる環境変数の設定の例を以下に示します。

export AWS_STS_REGIONAL_ENDPOINTS=regional

Windows のコマンドラインによる環境変数の設定の例を以下に示します。

setx AWS_STS_REGIONAL_ENDPOINTS regional

AWS SDK との互換性

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。すべての JVM システムプロパティ設定は、 AWS SDK for Java とでのみサポートされます。 AWS SDK for Kotlin

SDK	サポート	注意または詳細情報
AWS CLI v2	部分的	デフォルト値は regional です。
SDK for C++	部分的	環境変数と config ファイル設定はサポートされていません。SDK は regional 設定で実行します。
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	No
SDK for .NET 3.x	Yes
SDK for PHP 3.x	Yes
SDK for Python (Boto3)	Yes
SDK for Ruby 3.x	Yes
SDK for Rust	Yes
以下のためのツール PowerShell	Yes