Paramètres de configuration intelligents par défaut

Configurez cette fonctionnalité à l'aide des méthodes suivantes :

defaults_mode- réglage des AWS config fichiers partagés

AWS_DEFAULTS_MODE- variable d'environnement

aws.defaultsMode- Propriété du système JVM : uniquement Java/Kotlin

Ce paramètre vous permet de choisir un mode adapté à l'architecture de votre application, qui fournit ensuite des valeurs par défaut optimisées pour votre application. Si une valeur est définie explicitement pour un paramètre du AWS SDK, cette valeur est toujours prioritaire. Si aucune valeur n'est définie explicitement pour un paramètre du AWS SDK et qu'elle n'defaults_modeest pas égale à l'ancienne, cette fonctionnalité peut fournir différentes valeurs par défaut pour différents paramètres optimisés pour votre application. Les paramètres peuvent inclure les éléments suivants : les paramètres de communication HTTP, le comportement des nouvelles tentatives, les paramètres du point de terminaison régional du service et, éventuellement, toute SDK-related configuration. Les clients qui utilisent cette fonctionnalité peuvent obtenir de nouvelles valeurs de configuration par défaut adaptées aux scénarios d'utilisation courants. Si votre valeur n'defaults_modeest pas égale àlegacy, nous vous recommandons de tester votre application lors de la mise à niveau du SDK, car les valeurs par défaut fournies peuvent changer en fonction de l'évolution des meilleures pratiques.

Valeur par défaut : legacy

Remarque : Les nouvelles versions majeures des kits de développement logiciel seront définies par défaut surstandard.

Valeurs valides:

• legacy— Fournit des paramètres par défaut qui varient selon le SDK et existaient avant la création dedefaults_mode.

• standard— Fournit les dernières valeurs par défaut recommandées qui devraient pouvoir être exécutées en toute sécurité dans la plupart des scénarios.

• in-region— S'appuie sur le mode standard et inclut une optimisation adaptée aux applications qui appellent Services AWS depuis le même mode Région AWS.

• cross-region— S'appuie sur le mode standard et inclut une optimisation adaptée aux applications qui appellent Services AWS dans une autre région.

• mobile— S'appuie sur le mode standard et inclut une optimisation adaptée aux applications mobiles.

• auto : s’appuie sur le mode standard et inclut des fonctionnalités expérimentales. Le kit SDK tente de découvrir l’environnement d’exécution afin de déterminer automatiquement les paramètres appropriés. La détection automatique est basée sur des heuristiques et ne fournit pas une précision de 100 %. Si l'environnement d'exécution ne peut pas être déterminé, standard le mode est utilisé. La détection automatique peut interroger les métadonnées de l'instance, ce qui peut introduire une latence. Si la latence de démarrage est essentielle pour votre application, nous vous recommandons de choisir plutôt un defaults_mode explicite.

Exemple de définition de cette valeur dans le config fichier :

[default]
defaults_mode = standard

Les paramètres suivants peuvent être optimisés en fonction de la sélection de defaults_mode :

• retryMode— Spécifie la manière dont le SDK tente de relancer les tentatives. Consultez Comportement de nouvelle tentative.

• stsRegionalEndpoints— Spécifie comment le SDK détermine le Service AWS point de terminaison qu'il utilise pour communiquer avec le AWS Security Token Service (AWS STS). Consultez AWS STS Points de terminaison régionaux.

• s3UsEast1RegionalEndpoints— Spécifie comment le SDK détermine le point de terminaison de AWS service qu'il utilise pour communiquer avec Amazon S3 pour la us-east-1 région.

• connectTimeoutInMillis— Après une première tentative de connexion sur un socket, délai avant l'expiration du délai. Si le client ne reçoit pas de confirmation de l'établissement de la connexion, il abandonne et échoue à l'opération.

• tlsNegotiationTimeoutInMillis— Durée maximale qu'une prise de contact TLS peut prendre entre le moment où le message CLIENT HELLO est envoyé et le moment où le client et le serveur ont entièrement négocié les chiffrements et échangé les clés.