スマート設定デフォルト

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

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

AWS_DEFAULTS_MODE - 環境変数

aws.defaultsMode - JVM システムプロパティ: Java/Kotlin のみ

この設定では、アプリケーションアーキテクチャに合ったモードを選択できます。これにより、アプリケーションに最適なデフォルト値が使用できるようになります。AWS SDK 設定に明示的に値が設定されている場合は、その値が常に優先されます。AWS SDK 設定に明示的に値が設定されておらず、defaults_mode がレガシーと等しくない場合、この機能ではアプリケーションに最適化されたさまざまな設定に異なるデフォルト値を使用できます。設定には、HTTP 通信設定、再試行動作、サービスの地域エンドポイント設定、および SDK 関連のあらゆる設定が含まれる可能性があります。この機能を使用するお客様は、一般的な使用シナリオに合わせた新しいデフォルト設定を取得できます。defaults_mode が legacy と等しくない場合は、SDK をアップグレードするときにアプリケーションのテストを行うことをおすすめします。これは、ベストプラクティスの進化によってこの機能のデフォルト値が変わる可能性があるためです。

デフォルト値: legacy

注意：SDK の新しいメジャーバージョンでのデフォルトは standard になります。

有効な値:

• legacy – SDK によって異なり、defaults_mode が確立される前から存在していたデフォルト設定を使用します。

• standard – ほとんどのシナリオで安全に実行できる最新の推奨デフォルト値を使用します。

• in-region – 標準モードに基づいて構築されており、同じ AWS リージョン 内から AWS のサービス を呼び出すアプリケーションに合わせた最適化が含まれています。

• cross-region – 標準モードに基づいて構築されており、別のリージョンから AWS のサービス を呼び出すアプリケーションに合わせた最適化が含まれています。

• mobile – 標準モードに基づいて構築されており、モバイルアプリケーションに合わせた最適化が含まれています。

• auto – 標準モードに基づいて構築されており、実験的な機能が含まれています。SDK はランタイム環境を検出して適切な設定を自動的に決定しようとします。自動検出はヒューリスティックに基づいてあり、100% の精度は得られません。ランタイム環境を特定できない場合は、standard モードが使用されます。自動検出では、インスタンスのメタデータをクエリすることがあり、レイテンシーが発生する可能性があります。起動時のレイテンシーがアプリケーションにとって最重要な場合は、代わりに明示的な defaults_mode を選択することをおすすめします。

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

[default]
defaults_mode = standard

以下のパラメータは、defaults_mode の選択に基づいて最適化される可能性があります。

• retryMode – SDK が再試行を試みる方法を指定します。「再試行動作」を参照してください。

• stsRegionalEndpoints – AWS Security Token Service (AWS STS) と通信するために使用する AWS のサービス エンドポイントを SDK が判別する方法を指定します。「AWS STS リージョンエンドポイント」を参照してください。

• s3UsEast1RegionalEndpoints – us-east-1 リージョンへの Amazon S3 と通信するために使用する AWS サービスエンドポイントを SDK が判別する方法を指定します。

• connectTimeoutInMillis – ソケットで初めて接続を試みた後、タイムアウトするまでの時間。クライアントが接続ハンドシェイクの完了を受け取らない場合、クライアントは断念しオペレーションは失敗します。

• tlsNegotiationTimeoutInMillis – CLIENT HELLO メッセージが送信されてから、クライアントとサーバーが暗号を完全にネゴシエートしてキーを交換するまでの TLS ハンドシェイクにかかる最大時間。