智慧組態預設值

使用下列設定此功能：

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

注意：新的 SDKs 主要版本預設為 standard。

有效值：

• legacy – 提供預設設定，這些設定會因 SDK 而異，並在建立 之前就已存在defaults_mode。

• standard – 提供應可在大多數情況下安全執行的最新建議預設值。

• in-region – 以標準模式為基礎，並包含針對 AWS 服務 在相同 內呼叫的應用程式所量身打造的最佳化 AWS 區域。

• cross-region – 以標準模式為基礎，包括針對 AWS 服務 在不同區域中呼叫的應用程式量身打造的最佳化。

• mobile – 以標準模式為基礎，包括為行動應用程式量身打造的最佳化。

• auto – 以標準模式為基礎，並包含實驗性功能。軟體開發套件會嘗試探索執行期環境，以自動判斷適當的設定。自動偵測是以啟發式為基礎，不提供 100% 的準確性。如果無法判斷執行期環境，則會使用 standard 模式。自動偵測可能會查詢執行個體中繼資料，這可能會導致延遲。如果啟動延遲對您的應用程式至關重要，建議您defaults_mode改為選擇明確。

在 config 檔案中設定此值的範例：

[default]
defaults_mode = standard

下列參數可根據 的選擇進行最佳化defaults_mode：

• retryMode – 指定 SDK 嘗試重試的方式。請參閱 重試行為。

• stsRegionalEndpoints – 指定 SDK 如何決定用來與 AWS Security Token Service () 交談的 AWS 服務 端點AWS STS。請參閱 AWS STS 區域端點。

• s3UsEast1RegionalEndpoints – 指定 SDK 如何判斷用來與 us-east-1 Amazon S3 的區域通訊 AWS 的服務端點。

• connectTimeoutInMillis – 在通訊端上進行初始連線嘗試後，逾時前的時間量。如果用戶端未收到連線交握的完成，用戶端會放棄操作並失敗。

• tlsNegotiationTimeoutInMillis – TLS 交握從傳送 CLIENT HELLO 訊息到用戶端和伺服器完整交涉密碼和交換金鑰的時間長度上限。