Configuración básica con la que trabajar Servicios de AWS - AWS SDK for Java 1.x
Información generalPosibilidad de iniciar sesión en el portal de AWS accesoConfigurar los archivos de configuración compartidosInstalar un entorno de desarrollo de Java.

La AWS SDK for Java versión 1.x entró en modo de mantenimiento el 31 de julio de 2024 y estará disponible el 31 de end-of-supportdiciembre de 2025. Le recomendamos que migre al para AWS SDK for Java 2.xseguir recibiendo nuevas funciones, 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.

Configuración básica con la que trabajar Servicios de AWS

Información general

Para desarrollar correctamente aplicaciones a las que se acceda Servicios de AWS mediante el AWS SDK for Java, se requieren las siguientes condiciones:

importante

En las instrucciones de esta sección de configuración se supone que usted o su organización utilizan IAM Identity Center. Si su organización utiliza un proveedor de identidad externo que funciona de forma independiente de IAM Identity Center, averigüe cómo puede obtener credenciales temporales SDK para que las utilice Java. Siga estas instrucciones para añadir credenciales temporales al archivo ~/.aws/credentials.

Si su proveedor de identidad añade credenciales temporales automáticamente al ~/.aws/credentials archivo, asegúrese de que el nombre del perfil es [default] tal que no tenga que proporcionárselo 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 IAM identidad. El formato de URL es d-xxxxxxxxxx.awsapps.com/start oyour_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 de autenticación de IAM Identity Center de la Guía de referencia sobre herramientas AWS SDKs y herramientas. No siga el paso 2 porque la versión AWS SDK for Java 1.x no admite la actualización automática de los tokens ni la recuperación automática de las credenciales temporales según lo descrito en el SDK paso 2.

Configurar los archivos de configuración compartidos

Los archivos de configuración compartidos se encuentran en la estación de trabajo de desarrollo y contienen los ajustes básicos que utilizan all AWS SDKs y (). AWS Command Line Interface CLI Los archivos de configuración compartidos pueden contener varios ajustes, pero estas instrucciones configuran los elementos básicos necesarios para trabajar con ellos. 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 al lugar donde planea ejecutar el código. Para obtener una lista de los códigos de región 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.

Siga las instrucciones de esta sección para crear el archivo config.

Configure credenciales temporales para el SDK

Una vez que tenga acceso a un IAM rol Cuenta de AWS y a través del portal de AWS acceso, configure su entorno de desarrollo con credenciales temporales SDK para el acceso.

Pasos para configurar un archivo credentials local con credenciales temporales

  1. Crear un archivo de credentials compartido.

  2. 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=<value from AWS access portal>
aws_secret_access_key=<value from AWS access portal>
aws_session_token=<value from AWS access portal>

  3. Guarde el archivo. El archivo ~/.aws/credentials debería existir ahora en su sistema de desarrollo local. Este archivo contiene el perfil [predeterminado] que utiliza SDK para Java si no se especifica un perfil con nombre específico.

  4. Inicie sesión en el portal de AWS acceso.

  5. Siga estas instrucciones que aparecen en el apartado Actualización manual de credenciales para copiar las credenciales de los IAM roles del portal de AWS acceso.

    1. En el paso 4 de las instrucciones enlazadas, elija el nombre del IAM rol que concede el acceso para sus necesidades de desarrollo. Este rol suele tener un nombre similar al PowerUserAccessde Desarrollador.

    2. Para el paso 7, seleccione la opción Agregar manualmente un perfil a su archivo de credenciales de AWS y copie el contenido.

  6. 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

  7. Guarde el archivo credentials.

SDKPara Java, accederá a estas credenciales temporales cuando cree un cliente de servicio y las utilice para cada solicitud. La configuración del IAM rol elegido en el paso 5a determina durante cuánto tiempo son válidas las credenciales temporales. 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 for Java V1 requiere una versión Java 7 JDK o posterior. Si utiliza la versión 1.12.767 o anteriorSDK, puede utilizar Java 7, pero si utiliza la versión 1.12.768 o posteriorSDK, necesitará Java 8. El repositorio central de Maven incluye la última versión de para Java. SDK

AWS SDK for Java Funciona con el kit de desarrollo Java SE de Oracle y con distribuciones del kit de desarrollo Open Java (OpenJDK), como Amazon Corretto, Red Hat JDK Open y Adoptium.