La AWS SDK para Java 1.x se alcanzó end-of-support el 31 de diciembre de 2025. Le recomendamos que migre a [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para seguir recibiendo nuevas características, mejoras de disponibilidad y actualizaciones de seguridad. 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. # Introducción Esta sección proporciona información sobre cómo instalar, configurar y utilizar AWS SDK para Java. **Topics** + [Configuración básica](signup-create-iam-user.md) + [Maneras de obtener el AWS SDK para Java](setup-install.md) + [Usar herramientas de compilación](setup-build-tools.md) + [Credenciales temporales y región](setup-credentials.md) # Configuración básica con la que trabajar Servicios de AWS ## Descripción general de Para desarrollar correctamente aplicaciones a las que se acceda Servicios de AWS mediante el AWS SDK para Java, se requieren las siguientes condiciones: + Debe poder [iniciar sesión en el portal de acceso a AWS](#setup-awsaccount) disponible en el AWS IAM Identity Center. + Los [permisos de la función de IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configurada para el SDK deben permitir el acceso a los Servicios de AWS que requiera la aplicación. Los permisos asociados a la política **PowerUserAccess** AWS gestionada son suficientes para la mayoría de las necesidades de desarrollo. + Un entorno de desarrollo con los siguientes elementos: + [Archivos de configuración compartidos](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) que se configuran de una de las siguientes maneras: + El `config` archivo contiene un perfil predeterminado que especifica un Región de AWS. + El archivo `credentials` contiene credenciales temporales como parte de un perfil predeterminado. + Una [instalación adecuada de Java](#java-dg-java-env). + Una [herramienta de automatización de compilaciones](setup-build-tools.md), como [Maven](https://maven.apache.org/download.cgi) o [Gradle](https://gradle.org/install/). + Un editor de texto para trabajar con código. + (Opcional, pero recomendado) Un IDE (entorno de desarrollo integrado) como [IntelliJ](https://www.jetbrains.com/idea/download/#section=windows) IDEA[,](https://www.eclipse.org/ide/) Eclipse o. [NetBeans](https://netbeans.org/downloads/) Cuando utilizas un IDE, también puedes integrarlo AWS Toolkit para trabajar con él más fácilmente. Servicios de AWS El [AWS Toolkit para IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) y el [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html) son dos kits de herramientas que puede utilizar para el desarrollo de Java. **importante** En las instrucciones de esta sección de configuración se supone que usted o su organización utilizan el Centro de identidad de IAM. Si su organización utiliza un proveedor de identidad externo que funciona de forma independiente del Centro de identidades de IAM, averigüe cómo puede obtener credenciales temporales para que las utilice el SDK para Java. Siga [estas instrucciones](#setup-temp-creds) para añadir credenciales temporales al archivo `~/.aws/credentials`. Si su proveedor de identidad agrega credenciales temporales automáticamente al archivo `~/.aws/credentials`, asegúrese de que el nombre del perfil sea `[default]` para que no necesite proporcionarlo al SDK o AWS CLI. ## Posibilidad de iniciar sesión en el portal de AWS acceso El portal de AWS acceso es la ubicación web en la que se inicia sesión manualmente en el Centro de Identidad de IAM. El formato de la URL es `d-xxxxxxxxxx.awsapps.com/start` o `your_subdomain.awsapps.com/start`. Si no está familiarizado con el portal de AWS acceso, siga las instrucciones para acceder a las cuentas que figuran en el [paso 1 del tema sobre la autenticación del Centro de Identidad de IAM](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) de la Guía de referencia sobre herramientas AWS SDKs y herramientas. No siga el paso 2 porque la versión AWS SDK para Java 1.x no admite la actualización automática de los tokens ni la recuperación automática de las credenciales temporales para el SDK que se describen en el paso 2. ## Configurar los archivos de configuración compartidos Los archivos de configuración compartidos residen en su estación de trabajo de desarrollo y contienen los ajustes básicos que utilizan todos AWS SDKs y la AWS Command Line Interface (CLI). Los archivos de configuración compartidos pueden contener [varios ajustes](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html), pero estas instrucciones configuran los elementos básicos necesarios para funcionar con el SDK. ### Configuración del archivo compartido `config` El ejemplo siguiente muestra el contenido de un archivo `config` compartido. ``` [default] region=us-east-1 output=json ``` Para fines de desarrollo, utilice el Región de AWS [más cercano](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) al lugar donde planea ejecutar el código. Para obtener una [lista de los códigos de región](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes) que se van a usar en el archivo `config`, consulte la guía Referencia general de Amazon Web Services . El ajuste `json` del formato de salida es uno de [varios valores posibles](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html). Siga las instrucciones [de esta sección](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) para crear el archivo `config`. ### Configure credenciales temporales para el SDK. Cuando tenga acceso a un Cuenta de AWS rol de IAM a través del portal de AWS acceso, configure su entorno de desarrollo con credenciales temporales para que el SDK pueda acceder a él. **Pasos para configurar un archivo `credentials` local con credenciales temporales** 1. [Crear un archivo de `credentials` compartido](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html). 1. En el archivo `credentials`, pegue el siguiente texto de marcador de posición hasta que pegue las credenciales temporales que funcionen. ``` [default] aws_access_key_id= aws_secret_access_key= aws_session_token= ``` 1. Guarde el archivo. El archivo `~/.aws/credentials` debería existir ahora en su sistema de desarrollo local. Este archivo contiene el [perfil [predeterminado]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) que el SDK para Java utiliza si no se especifica un perfil con nombre específico. 1. [Inicie sesión en el portal de AWS acceso.](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html) 1. Siga estas instrucciones que aparecen en el apartado [Actualización manual de credenciales](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) para copiar las credenciales de los roles de IAM del portal de AWS acceso. 1. Para el paso 4 de las instrucciones vinculadas, elija el nombre del rol de IAM que le concede acceso para sus necesidades de desarrollo. **Este rol suele tener un nombre similar **PowerUserAccess**al de Desarrollador.** 1. Para el paso 7, seleccione la opción **Agregar manualmente un perfil a su archivo de credenciales de AWS ** y copie el contenido. 1. Pegue las credenciales copiadas en su archivo `credentials` local y elimine cualquier nombre de perfil que se haya pegado. Su archivo debería parecerse a lo siguiente: ``` [default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE ``` 1. Guarde el archivo `credentials`. El SDK para Java accederá a estas credenciales temporales cuando cree un cliente de servicio y las utilizará para cada solicitud. La configuración del rol de IAM elegido en el paso 5a determina el [tiempo de validez de las credenciales temporales](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). La duración máxima es de doce horas. Cuando las credenciales temporales caduquen, repita los pasos del 4 al 7. ## Instalar un entorno de desarrollo de Java. La AWS SDK para Java V1 requiere un JDK Java 7 o posterior y todas las versiones del JDK Java LTS (soporte a largo plazo) son compatibles. Si usa la versión 1.12.767 o anterior del SDK, puede usar Java 7, pero si usa la versión 1.12.768 o posterior del SDK, se requiere Java 8. El [repositorio central de Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) muestra la última versión del SDK de Java. AWS SDK para Java [Funciona con el [kit de desarrollo Java SE de Oracle](https://www.oracle.com/java/technologies/downloads/) y con distribuciones del Open Java Development Kit (OpenJDK), como [Amazon Corretto](https://aws.amazon.com/corretto), [Red](https://developers.redhat.com/products/openjdk/overview) Hat OpenJDK y Adoptium.](https://adoptium.net/) # Maneras de obtener el AWS SDK para Java ## Requisitos previos Para usar el AWS SDK para Java, debe tener: + Debe poder [iniciar sesión en el portal de acceso a AWS](signup-create-iam-user.md#setup-awsaccount) disponible en el AWS IAM Identity Center. + Una [instalación adecuada de Java](signup-create-iam-user.md#java-dg-java-env). + Credenciales temporales configuradas en su archivo `credentials` compartido local. Consulte el tema [Configuración básica con la que trabajar Servicios de AWS](signup-create-iam-user.md) para obtener instrucciones sobre cómo configurar el uso del SDK para Java. ## Uso de una herramienta de compilación para administrar las dependencias del SDK para Java (recomendado) Le recomendamos usar Apache Maven o Gradle con su proyecto para acceder a las dependencias requeridas del SDK para Java.[ Esta sección](setup-build-tools.md) describe cómo utilizar esas herramientas. ## Descargar y extraer el SDK (no recomendable) Recomendamos utilizar una herramienta de compilación para acceder al SDK de su proyecto. Sin embargo, puede descargar un jar precompilado de la última versión del SDK. **nota** Para obtener información acerca de cómo descargar y compilar las versiones anteriores del SDK, consulte [Instalación de las versiones anteriores del SDK](#install-prev-sdk). 1. Descargue el SDK desde [https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip.](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip) 1. Después de descargar el SDK, extraiga el contenido en un directorio local. El SDK contiene los siguientes directorios: + `documentation`: contiene la documentación de la API (también disponible en la web: [Referencia de la API de AWS SDK para Java](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/)). + `lib`: contiene los archivos `.jar` del SDK. + `samples`: contiene código de ejemplo funcional que muestra cómo utilizar el SDK. + `third-party/lib`: contiene bibliotecas de terceros utilizadas por el SDK, como Apache commons registro, AspectJ y la plataforma Spring. Para usar el SDK, añada la ruta completa de los directorios `lib` y `third-party` a las dependencias en el archivo de compilación y a `CLASSPATH` de Java para ejecutar el código. ## Compilar versiones anteriores del SDK desde el código fuente (no se recomienda) Solo la última versión del SDK se proporciona en el formato precompilado como archivo jar descargable. Sin embargo, puede compilar una versión anterior del SDK a través de Apache Maven (código abierto). Maven descargará todas las dependencias necesarias, y compilará e instalará el SDK en un solo paso. Visite [http://maven.apache.org/](http://maven.apache.org/) para obtener instrucciones de instalación y más información. 1. Ve a la GitHub página del SDK en: [AWS SDK para Java (GitHub).](https://github.com/aws/aws-sdk-java) 1. Elija la etiqueta correspondiente al número de versión del SDK que desee. Por ejemplo, `1.6.10`. 1. Haga clic en el botón **Download ZIP (Descargar ZIP)** para descargar la versión del SDK que ha seleccionado. 1. Descomprima el archivo en un directorio de su sistema de desarrollo. En muchos sistemas, puede utilizar el administrador gráfico de archivos para realizar esta tarea o la utilidad `unzip` en una ventana de terminal. 1. En una ventana de terminal, vaya al directorio donde descomprimió el código fuente del SDK. 1. Compile e instale el SDK con el siguiente comando ([Maven](https://maven.apache.org/) ) necesario: ``` mvn clean install -Dgpg.skip=true ``` El archivo `.jar` resultante se compila en el directorio `target`. 1. (Opcional) Compile la documentación de referencia de la API usando el siguiente comando: ``` mvn javadoc:javadoc ``` La documentación se compila en el directorio `target/site/apidocs/`. # Usar herramientas de compilación El uso de herramientas de compilación ayuda a gestionar el desarrollo de los proyectos de Java. Hay varias herramientas de compilación disponibles, pero mostramos cómo ponerlas en marcha con dos herramientas de compilación populares: Maven y Gradle. En este tema, se muestra cómo utilizar estas herramientas de compilación para gestionar las dependencias del SDK para Java que necesita para sus proyectos. **Topics** + [Usar el SDK con Apache Maven](setup-project-maven.md) + [Usar el SDK con Gradle.](setup-project-gradle.md) # Usar el SDK con Apache Maven Puede utilizar [Apache Maven](https://maven.apache.org/) para configurar y compilar proyectos de AWS SDK para Java o para compilar el propio SDK. **nota** Debe tener Maven instalado para utilizar las instrucciones de este tema. Si aún no está instalado, visite [http://maven.apache.org/](http://maven.apache.org/) para descargarlo e instalarlo. ## Creación de un nuevo paquete de Maven Para crear un paquete de Maven básico, abra un ventana de terminal (línea de comandos) y ejecute: ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Sustituya *org.example.basicapp* por el espacio de nombres del paquete completo de su aplicación y *myapp* por el nombre del proyecto (este será el nombre del directorio de su proyecto). De forma predeterminada, crea una plantilla de proyecto que utiliza el arquetipo de [inicio rápido](http://maven.apache.org/archetypes/maven-archetype-quickstart/), lo que constituye un buen punto de partida para muchos proyectos. Hay más arquetipos disponibles; visite la página [Arquetipos de Maven](https://maven.apache.org/archetypes/index.html) para obtener una lista de arquetipos del paquete. Puede elegir un determinado arquetipo añadiendo el argumento `-DarchetypeArtifactId` al comando `archetype:generate`. Por ejemplo: ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **nota** Encontrará mucha más información sobre la creación y configuración de proyectos en la [Guía de introducción a Maven](https://maven.apache.org/guides/getting-started/). ## Configuración del SDK como una dependencia de Maven Para utilizar AWS SDK para Java en el proyecto, tendrá que declararlo como una dependencia en el archivo `pom.xml` del proyecto. A partir de la versión 1.9.0, puede importar [componentes individuales](#configuring-maven-individual-components) o [todo el SDK](#configuring-maven-entire-sdk). ### Especificación de módulos del SDK individuales Para seleccionar módulos individuales del SDK, utilice la lista de materiales (BOM) de AWS SDK para Java para Maven, con lo que se asegurará de que los módulos que especifique utilicen la misma versión del SDK y que sean compatibles entre sí. Para utilizar la lista de materiales, añada una sección `` al archivo `pom.xml` de su aplicación, añadiendo `aws-java-sdk-bom` como una dependencia y especificando la versión del SDK que desee utilizar: ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` Para ver la última versión de la lista de materiales de AWS SDK para Java disponible en Maven Central, visite: [https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom). También puede utilizar esta página para ver qué módulos (dependencias) administrados por la lista de materiales puede incluir en la sección `` del archivo `pom.xml` de su proyecto. Ahora puede seleccionar los módulos individuales del SDK que desea usar en su aplicación. Como ya ha declarado la versión del SDK en la lista de materiales, no necesita especificar el número de versión de cada componente. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` También puede consultar el *AWS Code Sample Catalog* para saber qué dependencias utilizar para un servicio de Servicio de AWS determinado. Consulte el archivo POM en un ejemplo de servicio específico. Por ejemplo, si está interesado en las dependencias del servicio AWS S3, consulte el [ejemplo completo](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) en GitHub. (Vea el pom en /java/example\$1code/s3). ### Importación de todos los módulos del SDK Si desea incluir *todo* el SDK como una dependencia, no utilice el método de lista de materiales; simplemente declárelo en su archivo `pom.xml` de la manera siguiente: ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Compilación del proyecto Una vez que haya configurado su proyecto, puede compilarlo mediante el comando `package` de Maven: ``` mvn package ``` Esto creará el archivo `–0—jar` en el directorio `target`. ## Compilación del SDK con Maven Puede utilizar Apache Maven para compilar el SDK desde el origen. Para ello, [descargue el código del SDK de GitHub](https://github.com/aws/aws-sdk-java), desempaquételo localmente y, a continuación, ejecute el siguiente comando de Maven: ``` mvn clean install ``` # Usar el SDK con Gradle. Para administrar las dependencias del SDK de tu proyecto de [Gradle](https://gradle.com/), importa la BOM de Maven correspondiente AWS SDK para Java al archivo de la aplicación. `build.gradle` **nota** En los siguientes ejemplos, reemplaza el archivo *1.12.529* de compilación por una versión válida de. AWS SDK para Java Busque la última versión disponible en el [repositorio central de Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuración del proyecto en Gradle 4.6 o posterior [A partir de Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), puede utilizar la característica de soporte de POM mejorada de Gradle para importar archivos de lista de materiales (BOM) declarando una dependencia en una BOM. 1. Si está utilizando Gradle 5.0 o posterior, vaya al paso 2. De lo contrario, habilite la característica *IMPROVED\$1POM\$1SUPPORT* en el archivo `settings.gradle`. ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Añada la BOM a la sección de *dependencias* del archivo `build.gradle`. ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Especifique los módulos del SDK que desea usar en la sección *dependencias*. Por ejemplo, lo siguiente incluye una dependencia para Amazon Simple Storage Service (Amazon S3). ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' ... } ``` Gradle resuelve automáticamente la versión correcta de las dependencias del SDK con la información de la BOM. A continuación se muestra un ejemplo de un `build.gradle` archivo completo que incluye una dependencia para Amazon S3. ``` group 'aws.test' version '1.0-SNAPSHOT' apply plugin: 'java' sourceCompatibility = 1.8 repositories { mavenCentral() } dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' } ``` **nota** En el ejemplo anterior, sustituya la dependencia por Amazon S3 las dependencias de los AWS servicios que utilizará en el proyecto. Los módulos (dependencias) que administra la AWS SDK para Java BOM se enumeran en el repositorio central de [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuración del proyecto para versiones de Gradle anteriores a 4.6 Las versiones de Gradle anteriores a 4.6 carecen de soporte de BOM nativo. Para administrar AWS SDK para Java las dependencias de tu proyecto, usa el [complemento de administración de dependencias](https://github.com/spring-gradle-plugins/dependency-management-plugin) de Spring para Gradle a fin de importar la BOM de Maven para el SDK. 1. Añada el complemento de administración de dependencias a su archivo `build.gradle` de aplicación. ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Añada la lista de materiales a la sección *dependencyManagement* del archivo. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Especifique los módulos del SDK que va a usar en la sección *dependencies*. Por ejemplo, en el siguiente se incluye una dependencia para Amazon S3. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` Gradle resuelve automáticamente la versión correcta de las dependencias del SDK con la información de la BOM. El siguiente es un ejemplo de un `build.gradle` archivo completo que incluye una dependencia para. Amazon S3 ``` group 'aws.test' version '1.0' apply plugin: 'java' sourceCompatibility = 1.8 repositories { mavenCentral() } buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } dependencies { compile 'com.amazonaws:aws-java-sdk-s3' testCompile group: 'junit', name: 'junit', version: '4.11' } ``` **nota** En el ejemplo anterior, sustituya la dependencia por Amazon S3 las dependencias del AWS servicio que utilizará en el proyecto. Los módulos (dependencias) que administra la AWS SDK para Java BOM se enumeran en el repositorio central de [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). Para obtener más información sobre cómo especificar las dependencias del SDK mediante la BOM, consulte [Uso del SDK con Apache Maven](setup-project-maven.md). # Configurar credenciales AWS temporales y Región de AWS para el desarrollo Para conectarse a cualquiera de los servicios compatibles con el AWS SDK para Java, debe proporcionar credenciales AWS temporales. *Las cadenas de proveedores AWS SDKs * y las CLIs utilizan para buscar credenciales AWS temporales en varios lugares diferentes, incluidas las variables de system/user entorno y los archivos de AWS configuración local. En este tema se proporciona información básica sobre cómo configurar sus credenciales AWS temporales para el desarrollo de aplicaciones locales mediante el AWS SDK para Java. Si necesita configurar las credenciales para utilizarlas en una instancia EC2 o si utiliza el IDE de Eclipse para desarrollo, consulte los siguientes temas: + Cuando utilice una instancia de EC2, cree una función de IAM y, a continuación, dé a su instancia de EC2 acceso a esa función, tal y como se muestra en la sección [Uso de funciones de IAM para conceder acceso a los](java-dg-roles.md) recursos. AWS Amazon EC2 + Configure las AWS credenciales en Eclipse mediante. [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/) Consulte [Configurar AWS credenciales](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html) en la [Guía del AWS Toolkit for Eclipse usuario](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/) para obtener más información. ## Configurar credenciales temporales Puede configurar las credenciales temporales para AWS SDK para Java el de varias maneras, pero estos son los enfoques recomendados: + Establezca las credenciales temporales en el archivo de perfil de AWS credenciales de su sistema local, ubicado en: + `~/.aws/credentials` en Linux, macOS o Unix + `C:\Users\USERNAME\.aws\credentials` en Windows Consulte las [Configure credenciales temporales para el SDK.](signup-create-iam-user.md#setup-temp-creds) en esta guía para sabre cómo obtener sus credenciales temporales. + Establezca las variables de entorno `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` y `AWS_SESSION_TOKEN`. Para establecer estas variables en Linux, MacOS, o Unix, utilice : ``` export AWS_ACCESS_KEY_ID=your_access_key_id export AWS_SECRET_ACCESS_KEY=your_secret_access_key export AWS_SESSION_TOKEN=your_session_token ``` Para establecer estas variables en Windows, utilice : ``` set AWS_ACCESS_KEY_ID=your_access_key_id set AWS_SECRET_ACCESS_KEY=your_secret_access_key set AWS_SESSION_TOKEN=your_session_token ``` + Para una instancia EC2, especifique un rol de IAM y conceda a la instancia EC2 acceso a dicho rol. Consulte las [funciones de IAM Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) en la Guía del Amazon EC2 usuario de instancias de Linux para obtener información detallada sobre su funcionamiento. Una vez que haya configurado sus credenciales AWS temporales mediante uno de estos métodos, las cargará automáticamente AWS SDK para Java mediante la cadena de proveedores de credenciales predeterminada. Para obtener más información sobre cómo trabajar con AWS credenciales en sus aplicaciones Java, consulte [Trabajar con AWS credenciales](credentials.md). ## Actualización de credenciales IMDS AWS SDK para Java Admite la opción de actualizar las credenciales de IMDS en segundo plano cada 1 minuto, independientemente del tiempo de caducidad de las credenciales. Esto le permite actualizar las credenciales con más frecuencia y reduce la posibilidad de que el hecho de no acceder al IMDS afecte a la disponibilidad percibida. AWS ``` 1. // Refresh credentials using a background thread, automatically every minute. This will log an error if IMDS is down during 2. // a refresh, but your service calls will continue using the cached credentials until the credentials are refreshed 3. // again one minute later. 4. 5. InstanceProfileCredentialsProvider credentials = 6. InstanceProfileCredentialsProvider.createAsyncRefreshingProvider(true); 7. 8. AmazonS3Client.builder() 9. .withCredentials(credentials) 10. .build(); 11. 12. // This is new: When you are done with the credentials provider, you must close it to release the background thread. 13. credentials.close(); ``` ## Configure el Región de AWS Debe establecer un valor predeterminado Región de AWS que se utilizará para acceder a AWS los servicios con AWS SDK para Java. Para disfrutar de un rendimiento de red óptimo, elija una región que esté geográficamente cerca de usted (o de sus clientes). Para obtener una lista de las regiones de cada servicio, consulte [Regiones y puntos finales](https://docs.aws.amazon.com/general/latest/gr/rande.html) en la Referencia Amazon Web Services general. **nota** Si *no* selecciona una región, se usará us-east-1 de forma predeterminada. Puede utilizar técnicas similares para configurar las credenciales para establecer su AWS región predeterminada: + Región de AWS Configúrala en el archivo de AWS configuración de tu sistema local, ubicado en: + \$1/.aws/config en Linux, macOS o Unix + C:\$1Users\$1USERNAME\$1.aws\$1config on Windows Este archivo debe contener líneas con el siguiente formato: \$1 ``` [default] region = your_aws_region ``` \$1 *Sustituya Región de AWS your\$1aws\$1region por lo que desee (por ejemplo, «us-east-1").* + Establezca la variable de entorno `AWS_REGION`. En Linux, macOS o Unix, utilice **``**: ``` export AWS_REGION=your_aws_region ``` En Windows, use ** `` **: ``` set AWS_REGION=your_aws_region ``` *Donde your\$1aws\$1region es el nombre deseado.* Región de AWS