Paramètres de configuration intelligents par défaut

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

defaults_mode- réglage AWS config du fichier partagé

AWS_DEFAULTS_MODE- variable d'environnement

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

Avec ce paramètre, vous pouvez choisir un mode qui s'aligne sur l'architecture de votre application, qui fournit ensuite des valeurs par défaut optimisées pour votre application. Si une valeur est explicitement définie 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'defaults_modeil n'est pas égal à l'ancien paramètre, cette fonctionnalité peut fournir des valeurs par défaut différentes 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 configuration liée au SDK. Les clients qui utilisent cette fonctionnalité peuvent obtenir de nouvelles configurations par défaut adaptées aux scénarios d'utilisation courants. Si vous defaults_mode n'êtes pas égal à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 de SDKs seront définies par défaut surstandard.

Valeurs valides:

• legacy— Fournit des paramètres par défaut qui varient selon le SDK et qui 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 faisant appel Services AWS à une région différente.

• 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 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 l'heuristique 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 de la latence. Si la latence de démarrage est essentielle pour votre application, nous vous recommandons de choisir une latence explicite à la defaults_mode place.

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 réessayer. Consultez Comportement de nouvelle tentative.

• stsRegionalEndpoints— Spécifie la manière dont 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 la manière dont le SDK détermine le point de terminaison du AWS service qu'il utilise pour communiquer avec Amazon S3 pour la us-east-1 région.

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

• tlsNegotiationTimeoutInMillis— Le temps maximum qu'une poignée de main 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.