Le AWS SDK pour Java 1.x a été atteint end-of-support le 31 décembre 2025. Nous vous recommandons de migrer vers le pour continuer [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)à bénéficier des nouvelles fonctionnalités, des améliorations de disponibilité et des mises à jour de sécurité. Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Démarrage Cette section fournit des informations sur 'installation, la configuration et l'utilisation du kit AWS SDK pour Java. **Topics** + [Configuration de base](signup-create-iam-user.md) + [ # Moyens d'obtenir le AWS SDK pour Java ](setup-install.md) + [ # Utiliser des outils de construction ](setup-build-tools.md) + [Informations d'identification temporaires et région](setup-credentials.md) # Configuration de base avec laquelle travailler Services AWS ## Présentation de Pour développer avec succès des applications qui accèdent à l' Services AWS aide de AWS SDK pour Java, les conditions suivantes sont requises : + Vous devez être en mesure de vous [connecter au portail AWS d'accès](#setup-awsaccount) disponible dans le AWS IAM Identity Center. + Les [autorisations du rôle IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) configuré pour le SDK doivent autoriser l'accès à Services AWS ce dont votre application a besoin. Les autorisations associées à la politique **PowerUserAccess** AWS gérée sont suffisantes pour répondre à la plupart des besoins de développement. + Un environnement de développement comprenant les éléments suivants : + Des [fichiers de configuration partagés](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) qui sont configurés de la manière suivante : + Le `config` fichier contient un profil par défaut qui spécifie un Région AWS. + Le `credentials` fichier contient des informations d'identification temporaires faisant partie d'un profil par défaut. + Une [installation appropriée de Java](#java-dg-java-env). + Un [outil d'automatisation de build](setup-build-tools.md) tel que [Maven](https://maven.apache.org/download.cgi) ou [Gradle](https://gradle.org/install/). + Un éditeur de texte pour travailler avec du code. + (Facultatif, mais recommandé) Un IDE (environnement de développement intégré) tel que [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows), [Eclipse](https://www.eclipse.org/ide/) ou. [NetBeans](https://netbeans.org/downloads/) Lorsque vous utilisez un IDE, vous pouvez également intégrer AWS Toolkit s pour travailler plus facilement avec Services AWS. Les [AWS Toolkit for IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)et [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html)sont deux boîtes à outils que vous pouvez utiliser pour le développement Java. **Important** Les instructions de cette section de configuration supposent que vous ou votre organisation utilisez IAM Identity Center. Si votre entreprise utilise un fournisseur d'identité externe qui fonctionne indépendamment d'IAM Identity Center, découvrez comment obtenir des informations d'identification temporaires à utiliser par le SDK for Java. Suivez [ces instructions](#setup-temp-creds) pour ajouter des informations d'identification temporaires au `~/.aws/credentials` fichier. Si votre fournisseur d'identité ajoute automatiquement des informations d'identification temporaires au `~/.aws/credentials` fichier, assurez-vous que le nom du profil est `[default]` tel que vous n'avez pas besoin de fournir un nom de profil au SDK ou AWS CLI. ## Possibilité de connexion au portail d' AWS accès Le portail AWS d'accès est l'emplacement Web où vous vous connectez manuellement à l'IAM Identity Center. Le format de l'URL est `d-xxxxxxxxxx.awsapps.com/start` ou`your_subdomain.awsapps.com/start`. Si vous ne connaissez pas le portail d' AWS accès, suivez les instructions relatives à l'accès au compte indiquées à l'[étape 1 de la rubrique sur l'authentification IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) du guide de référence sur les outils AWS SDKs et. Ne suivez pas l'étape 2 car la version AWS SDK pour Java 1.x ne prend pas en charge l'actualisation automatique des jetons ni la récupération automatique des informations d'identification temporaires pour le SDK décrit à l'étape 2. ## Configuration de fichiers de configuration partagés Les fichiers de configuration partagés résident sur votre poste de développement et contiennent les paramètres de base utilisés par tous AWS SDKs et par le AWS Command Line Interface (CLI). Les fichiers de configuration partagés peuvent contenir [un certain nombre de paramètres](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html), mais ces instructions définissent les éléments de base nécessaires à l'utilisation du SDK. ### Configuration du `config` fichier partagé L'exemple suivant montre le contenu d'un `config` fichier partagé. ``` [default] region=us-east-1 output=json ``` À des fins de développement, utilisez le code le Région AWS [plus proche](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) de l'endroit où vous prévoyez d'exécuter votre code. Pour une [liste des codes régionaux](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes) à utiliser dans le `config` fichier, consultez le Référence générale d'Amazon Web Services guide. Le `json` paramètre du format de sortie est l'une des [nombreuses valeurs possibles](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html). Suivez les instructions [de cette section](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) pour créer le `config` fichier. ### Configurer des informations d'identification temporaires pour le SDK Une fois que vous avez accès à un rôle Compte AWS et IAM via le portail AWS d'accès, configurez votre environnement de développement avec des informations d'identification temporaires auxquelles le SDK peut accéder. **Étapes pour configurer un `credentials` fichier local avec des informations d'identification temporaires** 1. [Créez un `credentials` fichier partagé](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html). 1. Dans le `credentials` fichier, collez le texte d'espace réservé suivant jusqu'à ce que vous y colliez des informations d'identification temporaires fonctionnelles. ``` [default] aws_access_key_id= aws_secret_access_key= aws_session_token= ``` 1. Enregistrez le fichier. Le fichier `~/.aws/credentials` devrait maintenant exister sur votre système de développement local. Ce fichier contient le [profil [par défaut]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) utilisé par le SDK for Java si aucun profil nommé spécifique n'est spécifié. 1. [Connectez-vous au portail d' AWS accès](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html). 1. Suivez ces instructions sous l'en-tête [Actualisation manuelle des informations d'identification](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) pour copier les informations d'identification du rôle IAM depuis le portail d' AWS accès. 1. Pour l'étape 4 des instructions liées, choisissez le nom du rôle IAM qui accorde l'accès pour vos besoins de développement. Ce rôle porte généralement un nom tel que **PowerUserAccess**« **Développeur** ». 1. Pour l'étape 7, sélectionnez l'option **Ajouter manuellement un profil à votre fichier AWS d'informations d'identification** et copiez le contenu. 1. Collez les informations d'identification copiées dans votre `credentials` fichier local et supprimez tout nom de profil collé. Votre fichier doit ressembler à ce qui suit : ``` [default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE ``` 1. Enregistrez le `credentials` fichier Le SDK for Java accède à ces informations d'identification temporaires lorsqu'il crée un client de service et les utilise pour chaque demande. Les paramètres du rôle IAM choisi à l'étape 5a déterminent [la durée de validité des informations d'identification temporaires](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). La durée maximale est de douze heures. Une fois les informations d'identification temporaires expirées, répétez les étapes 4 à 7. ## Installation d'un environnement de développement Java La AWS SDK pour Java V1 nécessite un JDK Java 7 ou une version plus récente et toutes les versions du JDK Java LTS (support à long terme) sont prises en charge. Si vous utilisez la version 1.12.767 ou une version antérieure du SDK, vous pouvez utiliser Java 7, mais si vous utilisez la version 1.12.768 ou ultérieure du SDK, Java 8 est requis. Le [référentiel central Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) répertorie la dernière version du SDK for Java. [https://developers.redhat.com/products/openjdk/overview](https://developers.redhat.com/products/openjdk/overview) # Moyens d'obtenir le AWS SDK pour Java ## Conditions préalables Pour utiliser le AWS SDK pour Java, vous devez avoir : + Vous devez être en mesure de vous [connecter au portail AWS d'accès](signup-create-iam-user.md#setup-awsaccount) disponible dans le AWS IAM Identity Center. + Une [installation appropriée de Java](signup-create-iam-user.md#java-dg-java-env). + Informations d'identification temporaires configurées dans votre `credentials` fichier partagé local. Consultez [Configuration de base avec laquelle travailler Services AWS](signup-create-iam-user.md) cette rubrique pour savoir comment configurer l'utilisation du SDK for Java. ## Utiliser un outil de génération pour gérer les dépendances du SDK for Java (recommandé) Nous vous recommandons d'utiliser Apache Maven ou Gradle avec votre projet pour accéder aux dépendances requises du SDK for Java. [ Cette section](setup-build-tools.md) décrit comment utiliser ces outils. ## Téléchargez et extrayez le SDK (non recommandé) Nous vous recommandons d'utiliser un outil de génération pour accéder au SDK de votre projet. Vous pouvez toutefois télécharger un fichier jar prédéfini contenant la dernière version du SDK. **Note** Pour plus d'informations sur le téléchargement et la génération des versions précédentes du kit SDK, consultez [Installation des versions précédentes du kit SDK](#install-prev-sdk). 1. Téléchargez le SDK depuis le [https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdkfichier .zip.](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip) 1. Après avoir téléchargé le kit SDK, décompressez le contenu dans un répertoire local. Le kit SDK contient les répertoires suivants : + `documentation`- contient la documentation de l'API (également disponible sur le Web : [AWS SDK pour Java API Reference](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/)). + `lib`- contient les `.jar` fichiers du SDK. + `samples`- contient un exemple de code fonctionnel qui montre comment utiliser le SDK. + `third-party/lib`- contient des bibliothèques tierces utilisées par le SDK, telles que Apache Commons Logging, AspectJ et le framework Spring. Pour utiliser le kit SDK, ajoutez le chemin d'accès complet des répertoires `lib` et `third-party` aux dépendances de votre fichier de génération, puis ajoutez-les à votre `CLASSPATH` Java pour exécuter votre code. ## Construire les versions précédentes du SDK à partir des sources (non recommandé) Seule la dernière version du SDK complet est fournie sous forme prédéfinie sous forme de fichier jar téléchargeable. Cependant, vous pouvez générer une version précédente du kit SDK avec Apache Maven (open source). Maven télécharge toutes les dépendances nécessaires, puis génère et installe le kit SDK, le tout en une seule étape. Pour plus d'informations et obtenir les instructions d'installation, consultez [http://maven.apache.org/](http://maven.apache.org/). 1. Accédez à la GitHub page du SDK à l'adresse : [AWS SDK pour Java (GitHub).](https://github.com/aws/aws-sdk-java) 1. Choisissez la balise correspondant au numéro de version du kit SDK de votre choix. Par exemple, `1.6.10`. 1. Cliquez sur le bouton **Download ZIP (Télécharger le zip)** pour télécharger la version du kit SDK que vous avez sélectionnée. 1. Décompressez le fichier dans un répertoire de votre système de développement. Sur de nombreux systèmes, vous pouvez utiliser votre gestionnaire de fichiers graphiques à cette fin, ou utilisez l'utilitaire `unzip` dans une fenêtre de terminal. 1. Dans une fenêtre de terminal, accédez au répertoire où vous avez décompressé le source du kit SDK. 1. Développez et installez le kit SDK avec la commande suivante ([Maven](https://maven.apache.org/) requis) : ``` mvn clean install -Dgpg.skip=true ``` Le fichier `.jar` généré est intégré au répertoire `target`. 1. (Facultatif) Générez la documentation de référence de l'API à l'aide de la commande suivante : ``` mvn javadoc:javadoc ``` La documentation est intégrée au répertoire `target/site/apidocs/`. # Utiliser des outils de construction L'utilisation d'outils de compilation permet de gérer le développement de projets Java. Plusieurs outils de construction sont disponibles, mais nous montrons comment démarrer avec deux outils de construction populaires : Maven et Gradle. Cette rubrique explique comment utiliser ces outils de génération pour gérer les dépendances du SDK for Java dont vous avez besoin pour vos projets. **Topics** + [ # Utilisation du kit SDK avec Apache Maven ](setup-project-maven.md) + [ # Utilisation du kit SDK avec Gradle ](setup-project-gradle.md) # Utilisation du kit SDK avec Apache Maven Vous pouvez utiliser [Apache Maven](https://maven.apache.org/) pour configurer et créer AWS SDK pour Java des projets, ou pour créer le SDK lui-même. **Note** Maven doit être installé sur votre ordinateur pour que vous puissiez utiliser les instructions de cette rubrique. Si tel n'est pas le cas, rendez-vous sur [http://maven.apache.org/](http://maven.apache.org/) pour le télécharger et l'installer. ## Création d'un package Maven Pour créer un package Maven de base, ouvrez une fenêtre de terminal (ligne de commande) et exécutez : ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Remplacez *org.example.basicapp* par l'espace de noms complet du package de votre application et *myapp* par le nom de votre projet (celui-ci devient le nom du répertoire de votre projet). Par défaut, crée un modèle de projet pour vous en utilisant l'archétype de [démarrage rapide](http://maven.apache.org/archetypes/maven-archetype-quickstart/), qui constitue un bon point de départ pour de nombreux projets. D'autres archétypes sont disponibles ; visitez la page des archétypes [Maven pour obtenir la liste des archétypes](https://maven.apache.org/archetypes/index.html) fournis avec. Vous pouvez choisir un archétype particulier à utiliser en ajoutant l'argument `-DarchetypeArtifactId` à la commande `archetype:generate`. Par exemple : ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **Note** De plus amples informations sur la création et la configuration de projets sont fournies dans le [guide de démarrage de Maven](https://maven.apache.org/guides/getting-started/). ## Configuration du kit SDK en tant que dépendance Maven Pour utiliser le AWS SDK pour Java dans votre projet, vous devez le déclarer en tant que dépendance dans le `pom.xml` fichier de votre projet. Depuis la version 1.9.0, vous pouvez importer des [composants individuels](#configuring-maven-individual-components) ou l'[intégralité du kit SDK](#configuring-maven-entire-sdk). ### Spécification individuelle des modules SDK Pour sélectionner des modules du SDK individuels, utilisez la AWS SDK pour Java nomenclature (BOM) de Maven, qui garantit que les modules que vous spécifiez utilisent la même version du SDK et qu'ils sont compatibles les uns avec les autres. Pour utiliser la nomenclature, ajoutez une section `` au fichier `pom.xml` de votre application, en ajoutant `aws-java-sdk-bom` en tant que dépendance et en spécifiant la version du kit SDK que vous voulez utiliser : ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` [Pour consulter la dernière version de la AWS SDK pour Java nomenclature disponible sur Maven Central, rendez-vous sur : https://mvnrepository.com/artifact/ com.amazonaws/. aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Vous pouvez également utiliser cette page pour savoir quels sont les modules (dépendances) gérés par la nomenclature et que vous pouvez inclure dans la section `` du fichier `pom.xml` de votre projet. Vous pouvez maintenant sélectionner individuellement les modules du kit SDK que vous utilisez dans votre application. Dans la mesure où vous avez déjà déclaré la version du kit SDK dans la nomenclature, il n'est pas nécessaire de spécifier le numéro de version de chaque composant. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` Vous pouvez également vous référer au * Catalogue d'exemples de code AWS *pour savoir quelles dépendances utiliser pour une donnée Service AWS. Reportez-vous au fichier POM sous un exemple de service spécifique. Par exemple, si vous êtes intéressé par les dépendances du service AWS S3, consultez l'[exemple complet](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) sur GitHub. (Regardez le pompon under /java/example\$1code/s 3). ### Importation de tous les modules SDK Si vous souhaitez enregistrer l'*intégralité* du kit SDK comme dépendance, n'utilisez pas la méthode de nomenclature, mais déclarez simplement le kit SDK dans votre fichier `pom.xml`, comme suit : ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Génération de votre projet Une fois que vous avez configuré votre projet, vous pouvez le générer à l'aide de la commande Maven `package` : ``` mvn package ``` Cette opération crée votre fichier `–0—jar` dans le répertoire `target`. ## Génération du kit SDK avec Maven Vous pouvez utiliser Apache Maven pour générer le kit SDK à partir du code source. Pour ce faire, [téléchargez le code du SDK depuis GitHub](https://github.com/aws/aws-sdk-java), décompressez-le localement, puis exécutez la commande Maven suivante : ``` mvn clean install ``` # Utilisation du kit SDK avec Gradle Pour gérer les dépendances du SDK pour votre projet [Gradle](https://gradle.com/), importez la nomenclature Maven correspondante AWS SDK pour Java dans le fichier de l'application. `build.gradle` **Note** Dans les exemples suivants, remplacez *1.12.529* le fichier de compilation par une version valide du AWS SDK pour Java. Trouvez la dernière version dans le [référentiel central de Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuration du projet pour Gradle version 4.6 ou ultérieure [Depuis Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), vous pouvez utiliser la fonctionnalité de support POM améliorée de Gradle pour importer des fichiers de nomenclature (BOM) en déclarant une dépendance à une nomenclature. 1. Si vous utilisez Gradle version 5.0 ou ultérieure, passez à l'étape 2. Sinon, activez la fonction *IMPROVED\$1POM\$1SUPPORT* dans le fichier `settings.gradle`. ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Ajoutez la nomenclature à la section des *dépendances* du `build.gradle` fichier de l'application. ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Spécifiez les modules SDK que vous souhaitez utiliser dans la section des *dépendances*. Par exemple, ce qui suit inclut une dépendance pour 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 résout automatiquement la version correcte des dépendances de votre kit SDK à l'aide des informations de la nomenclature. Voici un exemple de `build.gradle` fichier complet qui inclut une dépendance pour 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' } ``` **Note** Dans l'exemple précédent, remplacez la dépendance pour Amazon S3 par les dépendances des AWS services que vous utiliserez dans votre projet. Les modules (dépendances) gérés par le AWS SDK pour Java BOM sont répertoriés dans le référentiel [central Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Configuration de projet pour les versions de Gradle antérieures à la version 4.6 Les versions de Gradle antérieures à la version 4.6 ne prennent pas en charge la nomenclature native. Pour gérer les AWS SDK pour Java dépendances de votre projet, utilisez le [plugin de gestion des dépendances](https://github.com/spring-gradle-plugins/dependency-management-plugin) de Spring pour Gradle afin d'importer la nomenclature Maven pour le SDK. 1. Ajoutez le plugin de gestion des dépendances au `build.gradle` fichier de votre application. ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Ajoutez la nomenclature dans la section *dependencyManagement* du fichier. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Spécifiez les modules SDK que vous utiliserez dans la section des *dépendances*. L'exemple suivant inclut une dépendance pour Amazon S3. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` Gradle résout automatiquement la version correcte des dépendances de votre kit SDK à l'aide des informations de la nomenclature. Voici un exemple de `build.gradle` fichier complet qui inclut une dépendance pour 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' } ``` **Note** Dans l'exemple précédent, remplacez la dépendance pour Amazon S3 par les dépendances du AWS service que vous utiliserez dans votre projet. Les modules (dépendances) gérés par le AWS SDK pour Java BOM sont répertoriés dans le référentiel [central Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). Pour plus de détails sur la spécification des dépendances du kit SDK à l'aide de la nomenclature, consultez [Utilisation du kit SDK avec Apache Maven](setup-project-maven.md). # Configurer des informations d'identification AWS temporaires et Région AWS pour le développement Pour vous connecter à l'un des services pris en charge avec le AWS SDK pour Java, vous devez fournir des informations d'identification AWS temporaires. Les *chaînes de fournisseurs AWS SDKs * et d' CLIs utilisation permettent de rechercher des informations d'identification AWS temporaires à différents endroits, notamment dans les variables d' system/user environnement et les fichiers AWS de configuration locaux. Cette rubrique fournit des informations de base sur la configuration de vos informations d'identification AWS temporaires pour le développement d'applications locales à l'aide du AWS SDK pour Java. Si vous devez configurer des informations d'identification à utiliser dans une instance EC2 ou si vous utilisez l'IDE Eclipse pour le développement, veuillez plutôt consulter les rubriques suivantes : + Lorsque vous utilisez une instance EC2, créez un rôle IAM, puis accordez à votre instance EC2 l'accès à ce rôle, comme indiqué dans [Utilisation de rôles IAM pour accorder l'accès aux](java-dg-roles.md) ressources sur. AWS Amazon EC2 + Configurez les AWS informations d'identification dans Eclipse à l'aide du [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/). Voir [Configurer les AWS informations d'identification](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html) dans le [guide de AWS Toolkit for Eclipse l'utilisateur](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/) pour plus d'informations. ## Configurer les informations d'identification temporaires Vous pouvez configurer des informations d'identification temporaires pour le AWS SDK pour Java de différentes manières, mais voici les approches recommandées : + Définissez des informations d'identification temporaires dans le fichier de profil des AWS informations d'identification de votre système local, situé à l'adresse suivante : + `~/.aws/credentials` sous Linux, macOS ou Unix + `C:\Users\USERNAME\.aws\credentials` sous Windows Consultez ce guide pour savoir comment obtenir vos informations d'identification temporaires. [Configurer des informations d'identification temporaires pour le SDK](signup-create-iam-user.md#setup-temp-creds) + Définissez les variables `AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY`, et d'`AWS_SESSION_TOKEN`environnement. Pour définir ces variables sous Linux, macOS ou Unix, utilisez : ``` 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 ``` Pour définir ces variables sous Windows, utilisez  : ``` 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 ``` + Pour une instance EC2, spécifiez un rôle IAM, puis autorisez l'instance EC2 à y accéder. Consultez la section [Rôles IAM Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) dans le guide de Amazon EC2 l'utilisateur pour les instances Linux pour une discussion détaillée sur son fonctionnement. Une fois que vous avez défini vos informations d'identification AWS temporaires à l'aide de l'une de ces méthodes, elles seront chargées automatiquement AWS SDK pour Java par le en utilisant la chaîne de fournisseurs d'informations d'identification par défaut. Pour plus d'informations sur l'utilisation des AWS informations d'identification dans vos applications Java, consultez la section [Utilisation des AWS informations d'identification](credentials.md). ## Actualisation des informations d'identification de l'IMDS Le AWS SDK pour Java support prend en charge l'actualisation des informations d'identification IMDS en arrière-plan toutes les 1 minute, quel que soit le délai d'expiration des informations d'identification. Cela vous permet d'actualiser les informations d'identification plus fréquemment et de réduire le risque que le fait de ne pas accéder à l'IMDS ait une incidence sur la AWS disponibilité perçue. ``` 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(); ``` ## Réglez le Région AWS Vous devez définir une valeur par défaut Région AWS qui sera utilisée pour accéder aux AWS services avec le AWS SDK pour Java. Pour des performances réseau optimales, choisissez une région qui est géographiquement proche de chez vous (ou de vos clients). Pour obtenir la liste des régions pour chaque service, voir [Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html) dans le manuel de référence Amazon Web Services général. **Note** Si vous *ne* sélectionnez aucune région, us-east-1 sera utilisé par défaut. Vous pouvez utiliser des techniques similaires pour définir les informations d'identification afin de définir votre AWS région par défaut : + Définissez le Région AWS dans le fichier de AWS configuration de votre système local, situé à l'adresse suivante : + \$1/.aws/config sous Linux, macOS ou Unix + C:\$1Users\$1USERNAME \$1 .aws \$1 config sous Windows Ce fichier doit contenir des lignes au format suivant : \$1 ``` [default] region = your_aws_region ``` \$1 *Remplacez la région de votre choix Région AWS (par exemple, « us-east-1 ») par your\$1aws\$1region.* + Définissez la variable d’environnement `AWS_REGION`. Sous Linux, macOS ou Unix, utilisez **``**: ``` export AWS_REGION=your_aws_region ``` Sous Windows, utilisez ** `` ** : ``` set AWS_REGION=your_aws_region ``` Où *your\$1aws\$1region* est le nom souhaité. Région AWS