Configurer des informations d'identificationAWS temporaires etRégion AWS pour le développement - AWS SDK for Java 1. x

Nous avons annoncé la sortie prochaine end-of-support de AWS SDK for Java (v1). Nous vous recommandons de migrer vers la AWS SDK for Java version v2. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, reportez-vous à l'annonce associée.

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.

Configurer des informations d'identificationAWS temporaires etRégion AWS pour le développement

Pour vous connecter à l'un des services pris en charge avec leAWS SDK for Java, vous devez fournir des informations d'identificationAWS temporaires. LesAWS kits SDK et les interface de ligne de commande utilisent les chaînes fournisseur pour rechercher les informations d'identificationAWS temporaires dans un certain nombre d'emplacements différents, y compris les variables d'environnement système ou utilisateur et les fichiersAWS de configuration locaux.

Cette rubrique fournit des informations de base sur la configuration de vos informations d'identificationAWS temporaires pour le développement d'applications locales à l'aide duAWS SDK for 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 :

Configurer les informations d'identification temporaires sous

Vous pouvez configurer des informations d'identification temporaires pour leAWS SDK for Java de différentes manières, mais voici les approches recommandées :

  • Définissez des informations d'identification temporaires dans le fichier de profil desAWS 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 obtenir des instructions sur la façon d'obtenir vos informations d'identification temporaires.Configurer des informations d'identification temporaires pour le SDK

  • DéfinissezAWS_ACCESS_KEY_ID les variables d'AWS_SESSION_TOKENenvironnementAWS_SECRET_ACCESS_KEY, et.

    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. Reportez-vous à la section Rôles IAMAmazon EC2 dans le Guide deAmazon EC2 l'utilisateur pour les instances Linux pour une discussion détaillée sur la façon dont cela fonctionne.

Une fois que vous avez défini vos informations d'identificationAWS temporaires à l'aide de l'une de ces méthodes, elles seront chargées automatiquementAWS SDK for Java par le à l'aide de la chaîne de fournisseurs d'informations d'identification par défaut. Pour plus d'informations sur l'utilisation desAWS informations d'identification dans vos applications Java, consultez la section Utilisation desAWS informations d'identification.

Actualisation des informations d'identification de l'IMDS

Le kit AWS SDK for Java prend en charge l'actualisation de l'inscription des informations d'identification de l'IMDS en arrière-plan toutes les minutes, quelle que soit la date 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 à IMDS ait une incidence sur laAWS 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 leRégion AWS

Vous devez définir une valeur par défautRégion AWS qui sera utilisée pour accéder auxAWS services avec leAWS SDK for 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 dans la RéférenceAmazon Web Services générale.

Note

Si vous ne sélectionnez aucune région, us-east-1 sera utilisé par défaut.

Vous pouvez utiliser des techniques similaires à la définition des informations d'identification pour définir votreAWS région par défaut :

  • Définissez leRégion AWS dans le fichier deAWS configuration de votre système local, situé à l'adresse suivante :

    • ~/......sous Linux, macOS ou macOS ou Unix sous Linux, macOS ou Unix sous Linux

    • C:\Users\USERNAME \ .aws \ config sous Windows

    Ce fichier doit contenir des lignes au format suivant :

    +

    [default] region = your_aws_region

    +

    Remplacez votre région souhaitéeRégion AWS (par exemple, « us-east-1 ») par your_aws_region.

  • Définissez la variable d'environnement AWS_REGION.

    Sous Linux, macOS ou Unix sous Linux, macOS ou Unix sous Linux, macOS ou Uni

    export AWS_REGION=your_aws_region

    Sous Windows, utilisez  :

    set AWS_REGION=your_aws_region

    your_aws_region est leRégion AWS nom souhaité.