View a markdown version of this page

Standardeinstellungen für intelligente Konfigurationen - AWS SDKs und Tools

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Standardeinstellungen für intelligente Konfigurationen

Anmerkung

Hilfe zum Verständnis des Layouts von Einstellungsseiten oder zur Interpretation der folgenden Tabelle mit Unterstützung durch AWS SDKs und Tools finden Sie unterDie Einstellungsseiten dieses Handbuchs verstehen.

Mit der Funktion „Smart Configuration Defaults“ können AWS SDKs vordefinierte, optimierte Standardwerte für andere Konfigurationseinstellungen bereitstellen.

Konfigurieren Sie diese Funktion mithilfe der folgenden Optionen:

defaults_mode- Einstellung für gemeinsam genutzte AWS config Dateien
AWS_DEFAULTS_MODE- Umgebungsvariable
aws.defaultsMode- JVM-Systemeigenschaft: nur Java/Kotlin

Mit dieser Einstellung können Sie einen Modus wählen, der zu Ihrer Anwendungsarchitektur passt und der dann optimierte Standardwerte für Ihre Anwendung bereitstellt. Wenn für eine AWS SDK-Einstellung ein Wert explizit festgelegt ist, hat dieser Wert immer Vorrang. Wenn für eine AWS SDK-Einstellung kein explizit festgelegter Wert festgelegt wurde und dieser defaults_mode Wert nicht mit Legacy übereinstimmt, kann diese Funktion unterschiedliche Standardwerte für verschiedene Einstellungen bereitstellen, die für Ihre Anwendung optimiert sind. Zu den Einstellungen können Folgendes gehören: HTTP-Kommunikationseinstellungen, Wiederholungsverhalten, Einstellungen für regionale Endpunkte des Dienstes und möglicherweise jede SDK-related Konfiguration. Kunden, die diese Funktion verwenden, können neue Standardkonfigurationen erhalten, die auf gängige Nutzungsszenarien zugeschnitten sind. Wenn Ihr nicht gleich defaults_mode ist, empfehlen wirlegacy, beim Upgrade des SDK Tests Ihrer Anwendung durchzuführen, da sich die angegebenen Standardwerte im Zuge der Weiterentwicklung der Best Practices ändern können.

Standardwert: legacy

Hinweis: Neue Hauptversionen von SDKs werden standardmäßig aufstandard.

Zulässige Werte:

  • legacy— Bietet Standardeinstellungen, die je nach SDK variieren und vor der Einrichtung von defaults_mode existierten.

  • standard— Stellt die neuesten empfohlenen Standardwerte bereit, die in den meisten Szenarien sicher ausgeführt werden können.

  • in-region— Baut auf dem Standardmodus auf und beinhaltet eine Optimierung, die auf Anwendungen zugeschnitten ist, die AWS-Services aus demselben heraus aufgerufen AWS-Region werden.

  • cross-region— Baut auf dem Standardmodus auf und beinhaltet eine Optimierung, die auf Anwendungen zugeschnitten ist, die AWS-Services in einer anderen Region aufgerufen werden.

  • mobile— Baut auf dem Standardmodus auf und beinhaltet eine Optimierung, die auf mobile Anwendungen zugeschnitten ist.

  • auto – Baut auf dem Standardmodus auf und beinhaltet experimentelle Features. Das SDK versucht, die Laufzeitumgebung zu ermitteln, um die entsprechenden Einstellungen automatisch zu ermitteln. Die automatische Erkennung basiert auf Heuristiken und bietet keine hundertprozentige Genauigkeit. Wenn die Laufzeitumgebung nicht bestimmt werden kann, standard wird der Modus verwendet. Die automatische Erkennung fragt möglicherweise Instanzmetadaten ab, was zu Latenz führen kann. Wenn die Startlatenz für Ihre Anwendung entscheidend ist, empfehlen wir, stattdessen einen expliziten defaults_mode zu wählen.

Beispiel für die Einstellung dieses Werts in der config Datei:

[default] defaults_mode = standard

Die folgenden Parameter können basierend auf der Auswahl von optimiert werdendefaults_mode:

  • retryMode— Gibt an, wie das SDK Wiederholungsversuche versucht. Siehe Wiederholungsverhalten.

  • stsRegionalEndpoints— Gibt an, wie das SDK den AWS-Service Endpunkt bestimmt, den es für die Kommunikation mit dem AWS -Security-Token-Service (AWS STS) verwendet. Siehe AWS STS Regionale -Endpunkte.

  • s3UsEast1RegionalEndpoints— Gibt an, wie das SDK den AWS Service-Endpunkt bestimmt, den es für die Kommunikation mit Amazon S3 für die us-east-1 Region verwendet.

  • connectTimeoutInMillis— Nach einem ersten Verbindungsversuch über einen Socket, die Zeitspanne bis zum Timeout. Wenn der Client keinen Abschluss des Verbindungs-Handshakes erhält, gibt der Client auf und der Vorgang schlägt fehl.

  • tlsNegotiationTimeoutInMillis— Die maximale Zeit, die ein TLS-Handshake vom Senden der CLIENT HELLO-Nachricht bis zu dem Zeitpunkt in Anspruch nehmen kann, an dem Client und Server die Chiffren vollständig ausgehandelt und Schlüssel ausgetauscht haben.

Der Standardwert für jede Einstellung ändert sich je nachdem, welche Einstellung für Ihre Anwendung defaults_mode ausgewählt wurde. Diese Werte sind derzeit wie folgt festgelegt (Änderungen vorbehalten):

Parameter Modus standard Modus in-region Modus cross-region Modus mobile
retryMode standard standard standard standard
stsRegionalEndpoints regional regional regional regional
s3UsEast1RegionalEndpoints regional regional regional regional
connectTimeoutInMillis 3100 1100 3100 30000
tlsNegotiationTimeoutInMillis 3100 1100 3100 30000

Wenn defaults_mode Sie beispielsweise ausgewählt habenstandard, standard würde der Wert für zugewiesen retry_mode (aus den gültigen retry_mode Optionen) und der Wert von regional würde für stsRegionalEndpoints (aus den gültigen stsRegionalEndpoints Optionen) zugewiesen werden.

Unterstützung von AWS SDKs und Tools

Die folgenden SDKs unterstützen die in diesem Thema beschriebenen Funktionen und Einstellungen. Alle teilweisen Ausnahmen werden vermerkt. Alle JVM-Systemeigenschaftseinstellungen werden von AWS SDK für Java and the AWS SDK für Kotlin only unterstützt.

SDK Unterstützt Hinweise oder weitere Informationen
AWS CLI   v2 Nein
SDK für C++ Ja Parameter nicht optimiert:stsRegionalEndpoints,s3UsEast1RegionalEndpoints,tlsNegotiationTimeoutInMillis.
SDK für Go V2 (1.x) Ja Parameter nicht optimiert:retryMode,stsRegionalEndpoints,s3UsEast1RegionalEndpoints.
SDK für Go 1.x (V1) Nein
SDK für Java 2.x Ja Parameter nicht optimiert:stsRegionalEndpoints.
SDK für Java 1.x Nein
SDK für 3.x JavaScript Ja Parameter nicht optimiert:stsRegionalEndpoints,s3UsEast1RegionalEndpoints,tlsNegotiationTimeoutInMillis. connectTimeoutInMilliswird aufgerufenconnectionTimeout.
SDK für JavaScript 2.x Nein
SDK für Kotlin Nein
SDK für.NET 4.x Ja Parameter nicht optimiert:connectTimeoutInMillis,tlsNegotiationTimeoutInMillis.
SDK für.NET 3.x Ja Parameter nicht optimiert:connectTimeoutInMillis,tlsNegotiationTimeoutInMillis.
SDK für PHP 3.x Ja Parameter nicht optimiert:tlsNegotiationTimeoutInMillis.
SDK für Python (Boto3) Ja Parameter nicht optimiert:. tlsNegotiationTimeoutInMillis
SDK für Ruby 3.x Ja
SDK für Rust Nein
SDK für Swift Nein
Tools für PowerShell V5 Ja Parameter nicht optimiert:connectTimeoutInMillis,tlsNegotiationTimeoutInMillis.
Tools für PowerShell V4 Ja Parameter nicht optimiert:connectTimeoutInMillis,tlsNegotiationTimeoutInMillis.