Valores predeterminados de configuración inteligente

Configure esta funcionalidad mediante lo siguiente:

defaults_mode: configuración de archivos config de AWS compartidos

AWS_DEFAULTS_MODE: variable de entorno

aws.defaultsMode: propiedad del sistema JVM: solo en Java/Kotlin

Con esta configuración, puede elegir un modo que se alinee con la arquitectura de la aplicación y, a continuación, proporcionar valores predeterminados optimizados para la aplicación. Si una configuración del AWS SDK tiene un valor establecido de forma explícita, ese valor siempre tiene prioridad. Si una configuración del AWS SDK no tiene un valor establecido de forma explícita y no es igual al defaults_mode antiguo, esta característica puede proporcionar diferentes valores predeterminados para diversas configuraciones optimizadas para tu aplicación. La configuración puede incluir lo siguiente: la configuración de comunicación HTTP, el comportamiento de los reintentos, la configuración del punto de conexión regional del servicio y, posiblemente, cualquier configuración relacionada con el SDK. Los clientes que utilizan esta característica pueden obtener nuevos valores predeterminados de configuración adaptados a los escenarios de uso habituales. Si su defaults_mode no es igual a su legacy, le recomendamos que realice pruebas en la aplicación cuando actualice el SDK, ya que los valores predeterminados proporcionados podrían cambiar a medida que evolucionen las prácticas recomendadas.

Valor predeterminado: legacy

Nota: Las nuevas versiones principales de los SDK se establecerán de forma predeterminada en standard.

Valores válidos:

• legacy: proporciona una configuración predeterminada que varía según el SDK y que existía antes de la creación de defaults_mode.

• standard: proporciona los últimos valores predeterminados recomendados que deberían poder ejecutarse de forma segura en la mayoría de los escenarios.

• in-region: se basa en el modo estándar e incluye una optimización adaptada a las aplicaciones que llaman a Servicios de AWS desde la misma Región de AWS.

• cross-region: se basa en el modo estándar e incluye una optimización adaptada a las aplicaciones que llaman a Servicios de AWS en una región diferente.

• mobile: se basa en el modo estándar e incluye una optimización adaptada a las aplicaciones móviles.

• auto: se basa en el modo estándar e incluye funciones experimentales. El SDK intenta descubrir el tiempo de ejecución para determinar automáticamente la configuración adecuada. La detección automática se basa en la heurística y no proporciona una precisión del 100 %. Si no se puede determinar el tiempo de ejecución, se utiliza el modo standard. La autodetección puede consultar los metadatos de la instancia y datos de usuario, lo que puede introducir latencia. Si la startup es fundamental para tu aplicación, te recomendamos que elijas un defaults_mode explícito en su lugar.

Ejemplo de configuración de este valor en el archivo config:

[default]
defaults_mode = standard

Los siguientes parámetros pueden optimizarse en función de la selección de defaults_mode:

• retryMode: especifica cómo el SDK intenta volver a intentarlo. Consulte Comportamiento de los reintentos.

• stsRegionalEndpoints: especifica cómo el SDK determina el punto de conexión de Servicio de AWS que utiliza para comunicarse con AWS Security Token Service (AWS STS). Consulte Puntos de conexión regionales de AWS STS.

• s3UsEast1RegionalEndpoints: especifica cómo el SDK determina el punto de conexión del servicio de AWS que utiliza para comunicarse con Amazon S3 para la región us-east-1.

• connectTimeoutInMillis: tras realizar un intento de conexión inicial en un socket, el tiempo transcurrido hasta que se agote el tiempo de espera. Si el cliente no recibe la finalización del apretón de manos de conexión, se da por vencido y no se realiza la operación.

• tlsNegotiationTimeoutInMillis: el tiempo máximo que puede tardar un protocolo de enlace TLS desde el momento en que se envía el mensaje CLIENT HELLO hasta el momento en que el cliente y el servidor han negociado completamente los cifrados e intercambiado claves.