Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración de clientes de servicio para el AWS SDK for Java 2.x exterior

Muchas opciones de configuración se pueden administrar fuera del código. Cuando administra la configuración de forma externa, puede aplicarse a todas las aplicaciones en el mismo proceso de Java. La mayoría de los ajustes de configuración se pueden establecer como variables de entorno, propiedades del sistema JVM o en un archivo compartido independiente. AWS config El archivo de config compartido puede mantener conjuntos de opciones independientes, denominados perfiles, para proporcionar diferentes configuraciones para distintos entornos o pruebas.

La mayoría de las variables de entorno y la configuración de los config archivos compartidos están estandarizadas y se comparten entre AWS SDKs sí, y son herramientas que permiten una funcionalidad uniforme en los diferentes lenguajes de programación y aplicaciones. En la mayoría de los casos, las propiedades del sistema JVM que puede usar el SDK para Java reflejan las variables de entorno.

Consulte la guía de referencia de herramientas AWS SDKs y la guía de referencia para obtener información sobre cómo configurar su aplicación mediante estos métodos, además de obtener información sobre cada configuración de varios SDK. Para ver todos los ajustes que el SDK puede resolver a partir de las variables de entorno, las propiedades del sistema JVM o los archivos de configuración, consulta la referencia sobre los ajustes en la Guía de referencia de herramientas AWS SDKs y herramientas.

Cadena de proveedores de configuración para la configuración del cliente

El SDK busca los valores de configuración en varios lugares (u orígenes).

Además de esta cadena de configuración general, el SDK de Java 2.x utiliza cadenas de proveedores especializados, como la cadena de proveedores de credenciales y la cadena de proveedores de Región de AWS. Estas cadenas especializadas agregan proveedores adicionales que tienen en cuenta el entorno en el que se ejecuta el SDK. Por ejemplo, en un contenedor o una instancia de EC2.

Creación de un cliente de servicio configurado mediante opciones externas

Debe crear un cliente de servicio en la aplicación para comunicarse con un Servicio de AWS. Los clientes de servicio son su punto de contacto esencial Servicios de AWS, ya que se encargan de todos los detalles complejos de la comunicación para que usted no tenga que preocuparse por ellos. Se ocupan automáticamente de tareas importantes como la seguridad, la gestión de errores y los reintentos, lo que le permite centrarse en crear la aplicación en lugar de lidiar con complicaciones técnicas.

Uso del método create()

Si todos los ajustes de configuración que necesita provienen de orígenes externos, puede crear un cliente de servicio con método sencillo:

S3Client s3Client = S3Client.create();

El fragmento de código anterior crea una instancia de S3Client. Durante la creación, el SDK busca la configuración en la cadena de proveedores de configuración. Una vez que el SDK encuentre un valor de configuración, el valor se utilizará incluso si existe una configuración que se encuentre más adelante en la cadena.

Por ejemplo, supongamos que un usuario establece la configuración de la JVM Región de AWS mediante la configuración de la propiedad -Daws.region=us-west-2 del sistema. Si la variable de entorno AWS_REGION también está establecida, se ignora su valor.

La cadena de proveedores predeterminados de la región y la cadena de proveedores de credenciales predeterminados también se utilizarán en el proceso de creación. En algún punto de la cadena, el SDK debe resolver la Región de AWS que se utilizará y encontrar la configuración que le permita recuperar las credenciales para firmar las solicitudes. Si los SDKs archivos buscan esos valores, se produce un error en la creación del cliente.

Si bien puede crear un cliente mediante este patrón de compilador vacío, suele utilizarse este patrón cuando se desea añadir una configuración en código.

Variables de entorno del SDK para Java 2.x y propiedades del sistema JVM

Además de los ajustes entre varios SDK compatibles con la mayoría AWS SDKs, el SDK for Java 2.x proporciona los siguientes ajustes.

Variables de entorno del proveedor de credenciales de contenedor

Además de las variables de entorno de credenciales de contenedor estándar documentadas en la guía de referencia, el SDK también admite:

AWS_CONTAINER_SERVICE_ENDPOINT: esta variable de entorno especifica el punto de conexión del servicio de metadatos del contenedor cuando se utiliza el proveedor de credenciales del contenedor.

Propiedades del sistema Java: aws.containerServiceEndpoint

Valor predeterminado: http://169.254.170.2

Variables de entorno de implementación del cliente HTTP

SYNC_HTTP_SERVICE_IMPL: identifica de forma explícita la implementación HTTP sincrónica predeterminada que utilizará el SDK. Resulta útil cuando hay varias implementaciones en la ruta de clases o para optimizar el rendimiento, ya que la detección de implementación requiere análisis de la ruta de clases.

Propiedades del sistema Java: software.amazon.awssdk.http.service.impl

ASYNC_HTTP_SERVICE_IMPL: identifica de forma explícita la implementación HTTP asincrónica predeterminada que utilizará el SDK. Resulta útil cuando hay varias implementaciones en la ruta de clases o para optimizar el rendimiento, ya que la detección de implementación requiere análisis de la ruta de clases.

Propiedades del sistema Java: software.amazon.awssdk.http.async.service.impl