Die Version AWS SDK für Java 1.x wurde end-of-support am 31. Dezember 2025 erreicht. Wir empfehlen Ihnen, auf den zu migrieren [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html), um weiterhin neue Funktionen, Verfügbarkeitsverbesserungen und Sicherheitsupdates zu erhalten. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Erste Schritte Dieser Abschnitt enthält Informationen zur Installation, Einrichtung und Verwendung des AWS SDK für Java. **Topics** + [Grundlegende Einrichtung](signup-create-iam-user.md) + [ # Möglichkeiten, das zu bekommen AWS SDK für Java ](setup-install.md) + [ # Verwenden Sie Build-Tools ](setup-build-tools.md) + [Temporäre Zugangsdaten und Region](setup-credentials.md) # Grundkonfiguration zum Arbeiten AWS-Services ## -Übersicht Für die erfolgreiche Entwicklung von Anwendungen, die AWS-Services über das zugreifen AWS SDK für Java, sind die folgenden Bedingungen erforderlich: + Sie müssen in der Lage sein, [sich bei dem AWS Zugangsportal anzumelden](#setup-awsaccount), das im verfügbar ist AWS IAM Identity Center. + Die [Berechtigungen der für das SDK konfigurierten IAM-Rolle](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) müssen den Zugriff auf die AWS-Services , die Ihre Anwendung benötigt, ermöglichen. Die mit der **PowerUserAccess** AWS verwalteten Richtlinie verbundenen Berechtigungen reichen für die meisten Entwicklungsanforderungen aus. + Eine Entwicklungsumgebung mit den folgenden Elementen: + [Gemeinsam genutzte Konfigurationsdateien](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html), die auf folgende Weise eingerichtet werden: + Die `config` Datei enthält ein Standardprofil, das eine spezifiziert AWS-Region. + Die `credentials` Datei enthält temporäre Anmeldeinformationen als Teil eines Standardprofils. + Eine geeignete [Installation von Java](#java-dg-java-env). + Ein [Tool zur Build-Automatisierung](setup-build-tools.md) wie [Maven](https://maven.apache.org/download.cgi) oder [Gradle](https://gradle.org/install/). + Ein Texteditor für die Arbeit mit Code. + (Optional, aber empfohlen) Eine IDE (integrierte Entwicklungsumgebung) wie [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows), [Eclipse](https://www.eclipse.org/ide/) oder. [NetBeans](https://netbeans.org/downloads/) Wenn Sie eine IDE verwenden, können Sie AWS Toolkit s auch integrieren, um die Arbeit mit ihnen zu vereinfachen. AWS-Services Die [AWS Toolkit for IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)und [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html)sind zwei Toolkits, die Sie für die Java-Entwicklung verwenden können. **Wichtig** Bei den Anweisungen in diesem Abschnitt zur Einrichtung wird davon ausgegangen, dass Sie oder Ihr Unternehmen IAM Identity Center verwenden. Wenn Ihre Organisation einen externen Identitätsanbieter verwendet, der unabhängig von IAM Identity Center arbeitet, finden Sie heraus, wie Sie temporäre Anmeldeinformationen für das SDK for Java erhalten können. Folgen Sie [diesen Anweisungen](#setup-temp-creds), um der `~/.aws/credentials` Datei temporäre Anmeldeinformationen hinzuzufügen. Wenn Ihr Identitätsanbieter der `~/.aws/credentials` Datei automatisch temporäre Anmeldeinformationen hinzufügt, stellen Sie sicher, dass der Profilname `[default]` so lautet, dass Sie dem SDK keinen Profilnamen angeben müssen oder AWS CLI. ## Anmeldemöglichkeit beim AWS Zugriffsportal Das AWS Zugriffsportal ist die Webadresse, über die Sie sich manuell beim IAM Identity Center anmelden. Das Format der URL ist `d-xxxxxxxxxx.awsapps.com/start` oder`your_subdomain.awsapps.com/start`. Wenn Sie mit dem AWS Zugriffsportal nicht vertraut sind, folgen Sie den Anweisungen für den Kontozugriff in [Schritt 1 des Themas IAM Identity Center-Authentifizierung](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch. Folgen Sie nicht Schritt 2, da AWS SDK für Java 1.x die automatische Token-Aktualisierung und den automatischen Abruf temporärer Anmeldeinformationen für das SDK, das in Schritt 2 beschrieben wird, nicht unterstützt. ## Richten Sie gemeinsam genutzte Konfigurationsdateien ein Die gemeinsam genutzten Konfigurationsdateien befinden sich auf Ihrer Entwicklungs-Workstation und enthalten grundlegende Einstellungen, die von all AWS SDKs und der AWS Command Line Interface (CLI) verwendet werden. Die gemeinsam genutzten Konfigurationsdateien können [eine Reihe von Einstellungen](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html) enthalten, aber in diesen Anweisungen werden die grundlegenden Elemente festgelegt, die für die Arbeit mit dem SDK erforderlich sind. ### Richten Sie die gemeinsam genutzte `config` Datei ein Das folgende Beispiel zeigt den Inhalt einer gemeinsam genutzten `config` Datei. ``` [default] region=us-east-1 output=json ``` Verwenden Sie für Entwicklungszwecke die Datei, die dem Ort AWS-Region [am nächsten](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) liegt, an dem Sie Ihren Code ausführen möchten. Eine [Liste der Regionalcodes](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes), die Sie in der `config` Datei verwenden können, finden Sie in der Allgemeine Amazon Web Services-Referenz Anleitung. Die `json` Einstellung für das Ausgabeformat ist einer von [mehreren möglichen Werten](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html). Folgen Sie den Anweisungen [in diesem Abschnitt](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html), um die `config` Datei zu erstellen. ### Richten Sie temporäre Anmeldeinformationen für das SDK ein Nachdem Sie über das Zugriffsportal AWS Zugriff auf eine AWS-Konto und IAM-Rolle erhalten haben, konfigurieren Sie Ihre Entwicklungsumgebung mit temporären Anmeldeinformationen für den Zugriff durch das SDK. **Schritte zum Einrichten einer lokalen `credentials` Datei mit temporären Anmeldeinformationen** 1. [Erstellen Sie eine gemeinsam genutzte `credentials` Datei](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html). 1. Fügen Sie den folgenden Platzhaltertext in die `credentials` Datei ein, bis Sie funktionierende temporäre Anmeldeinformationen einfügen. ``` [default] aws_access_key_id= aws_secret_access_key= aws_session_token= ``` 1. Speichern Sie die Datei. Die Datei `~/.aws/credentials` sollte jetzt auf Ihrem lokalen Entwicklungssystem vorhanden sein. Diese Datei enthält das [[Standard] -Profil](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile), das das SDK for Java verwendet, wenn kein bestimmtes benanntes Profil angegeben ist. 1. [Melden Sie sich beim AWS Access-Portal](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html) an. 1. Folgen Sie diesen Anweisungen unter der Überschrift [Manuelle Aktualisierung der Anmeldeinformationen](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials), um die Anmeldeinformationen für die IAM-Rolle aus dem AWS Zugriffsportal zu kopieren. 1. Wählen Sie für Schritt 4 der verlinkten Anleitung den IAM-Rollennamen aus, der den Zugriff für Ihre Entwicklungsanforderungen gewährt. Diese Rolle hat normalerweise einen Namen wie **PowerUserAccess**oder **Developer**. 1. Wählen Sie für Schritt 7 die Option **Manuelles Hinzufügen eines Profils zu Ihrer AWS Anmeldeinformationsdatei** und kopieren Sie den Inhalt. 1. Fügen Sie die kopierten Anmeldeinformationen in Ihre lokale `credentials` Datei ein und entfernen Sie alle eingefügten Profilnamen. Ihre Datei sollte wie folgt aussehen: ``` [default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE ``` 1. Speichern Sie die `credentials` Datei Das SDK for Java greift auf diese temporären Anmeldeinformationen zu, wenn es einen Service-Client erstellt und sie für jede Anfrage verwendet. Die in Schritt 5a ausgewählten Einstellungen für die IAM-Rolle bestimmen, [wie lange die temporären Anmeldeinformationen gültig sind](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). Die maximale Dauer beträgt zwölf Stunden. Wenn die temporären Anmeldeinformationen abgelaufen sind, wiederholen Sie die Schritte 4 bis 7. ## Installieren Sie eine Java-Entwicklungsumgebung Für AWS SDK für Java Version 1 ist ein Java 7 JDK oder neuer erforderlich, und alle JDK-Versionen von Java LTS (Long-Term Support) werden unterstützt. Wenn Sie Version 1.12.767 oder eine frühere Version des SDK verwenden, können Sie Java 7 verwenden. Wenn Sie jedoch Version 1.12.768 oder eine neuere Version des SDK verwenden, ist Java 8 erforderlich. Das [zentrale Maven-Repository](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) listet die neueste Version des SDK for Java auf. [Das AWS SDK für Java funktioniert mit dem [Oracle Java SE Development Kit](https://www.oracle.com/java/technologies/downloads/) und mit Distributionen von Open Java Development Kit (OpenJDK) wie [Amazon Corretto](https://aws.amazon.com/corretto), [Red Hat](https://developers.redhat.com/products/openjdk/overview) OpenJDK und Adoptium.](https://adoptium.net/) # Möglichkeiten, das zu bekommen AWS SDK für Java ## Voraussetzungen Um das verwenden zu können AWS SDK für Java, benötigen Sie: + Sie müssen in der Lage sein, [sich bei dem AWS Zugangsportal anzumelden](signup-create-iam-user.md#setup-awsaccount), das im verfügbar ist AWS IAM Identity Center. + Eine geeignete [Installation von Java](signup-create-iam-user.md#java-dg-java-env). + Temporäre Anmeldeinformationen, die in Ihrer lokalen gemeinsam genutzten `credentials` Datei eingerichtet sind. Anweisungen zur Einrichtung für die Verwendung des SDK for Java finden Sie im [Grundkonfiguration zum Arbeiten AWS-Services](signup-create-iam-user.md) Thema. ## Verwenden Sie ein Build-Tool, um Abhängigkeiten für das SDK for Java zu verwalten (empfohlen) Wir empfehlen, Apache Maven oder Gradle mit Ihrem Projekt zu verwenden, um auf die erforderlichen Abhängigkeiten des SDK for Java zuzugreifen. [ In diesem Abschnitt](setup-build-tools.md) wird beschrieben, wie Sie diese Tools verwenden. ## Laden Sie das SDK herunter und extrahieren Sie es (nicht empfohlen) Wir empfehlen, dass Sie ein Build-Tool verwenden, um auf das SDK für Ihr Projekt zuzugreifen. Sie können jedoch ein vorgefertigtes JAR der neuesten Version des SDK herunterladen. **Anmerkung** Weitere Informationen zum Herunterladen und Erstellen von früheren Versionen des SDKs finden Sie unter [Installieren von früheren Versionen des SDKs](#install-prev-sdk). 1. Laden Sie das SDK aus der ZIP-Datei herunter [https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip) 1. Extrahieren Sie den Inhalt nach dem Herunterladen des SDKs in ein lokales Verzeichnis. Das SDK enthält folgende Verzeichnisse: + `documentation`- enthält die API-Dokumentation (auch im Internet verfügbar: [AWS SDK für Java API-Referenz).](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/) + `lib`- enthält die `.jar` SDK-Dateien. + `samples`- enthält einen funktionierenden Beispielcode, der demonstriert, wie das SDK verwendet wird. + `third-party/lib`- enthält Bibliotheken von Drittanbietern, die vom SDK verwendet werden, wie Apache Commons Logging, AspectJ und das Spring-Framework. Um das SDK zu verwenden, fügen Sie den vollständigen Pfad zu den Verzeichnissen `lib` und `third-party` zu den Abhängigkeiten in Ihrer Build-Datei hinzu und fügen Sie sie zu Ihrem Java-`CLASSPATH` hinzu, um Ihren Code auszuführen. ## Frühere Versionen des SDK aus dem Quellcode erstellen (nicht empfohlen) Nur die neueste Version des vollständigen SDK wird in vorgefertigter Form als herunterladbares JAR bereitgestellt. Sie können jedoch eine vorherige Version des SDKs mit Apache Maven (Open Source) erstellen. Maven lädt alle erforderlichen Abhängigkeiten, erstellt und installiert das SDK in einem Schritt. Besuchen Sie [http://maven.apache.org/](http://maven.apache.org/), um Installationsanweisungen und weitere Informationen zu erhalten. 1. Gehen Sie zur GitHub SDK-Seite unter: [AWS SDK für Java (GitHub)](https://github.com/aws/aws-sdk-java). 1. Wählen Sie das Tag aus, das der gewünschten SDK-Versionsnummer entspricht. Beispiel, `1.6.10`. 1. Klicken Sie auf die Schaltfläche **Download ZIP**, um die ausgewählte Version des SDKs herunterzuladen. 1. Extrahieren Sie die Datei in ein Verzeichnis auf Ihrem Entwicklungssystem. Bei vielen Systemen können Sie dazu den grafischen Datei-Manager oder das `unzip`-Dienstprogramm in einem Terminal-Fenster nutzen. 1. Navigieren Sie in einem Terminal-Fenster in das Verzeichnis, in das Sie die SDK-Quelldateien entpackt haben. 1. Erstellen und installieren Sie das SDK mit dem folgenden Befehl ([Maven](https://maven.apache.org/) erforderlich): ``` mvn clean install -Dgpg.skip=true ``` Die resultierende `.jar`-Datei wird im `target`-Verzeichnis erstellt. 1. (Optional) Erstellen Sie die API-Referenz-Dokumentation mit dem folgenden Befehl: ``` mvn javadoc:javadoc ``` Die Dokumentation wird im Verzeichnis `target/site/apidocs/` erstellt. # Verwenden Sie Build-Tools Die Verwendung von Build-Tools hilft bei der Verwaltung der Entwicklung von Java-Projekten. Es sind mehrere Build-Tools verfügbar, aber wir zeigen, wie Sie mit zwei beliebten Build-Tools, Maven und Gradle, loslegen können. In diesem Thema erfahren Sie, wie Sie mit diesen Build-Tools die SDK for Java Java-Abhängigkeiten verwalten, die Sie für Ihre Projekte benötigen. **Topics** + [ # Das SDK mit Apache Maven verwenden ](setup-project-maven.md) + [ # Das SDK mit Gradle verwenden ](setup-project-gradle.md) # Das SDK mit Apache Maven verwenden Sie können [Apache Maven](https://maven.apache.org/) verwenden, um AWS SDK für Java Projekte zu konfigurieren und zu erstellen oder um das SDK selbst zu erstellen. **Anmerkung** Um die Anleitungen in diesem Thema nachzuvollziehen, sollten Sie Maven installiert haben. Wenn Maven noch nicht installiert ist, besuchen Sie [http://maven.apache.org/](http://maven.apache.org/), um es herunterzuladen und zu installieren. ## Erstellen eines neuen Maven-Pakets Sie können ein einfaches Maven-Paket erstellen, indem Sie ein Terminal-Fenster (eine Befehlszeile) öffnen und Folgendes ausführen: ``` mvn -B archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DgroupId=org.example.basicapp \ -DartifactId=myapp ``` Ersetzen Sie *org.example.basicapp* mit dem vollen Paket-Namespace Ihrer Anwendung und *myapp* mit dem Projektnamen (wird für den Verzeichnisnamen Ihres Projekts übernommen). Erstellt standardmäßig eine Projektvorlage für Sie unter Verwendung des [Schnellstart-Archetyps](http://maven.apache.org/archetypes/maven-archetype-quickstart/), der für viele Projekte ein guter Ausgangspunkt ist. Es sind noch mehr Archetypen verfügbar. Auf der [Maven-Archetypen-Seite findest du eine Liste der Archetypen](https://maven.apache.org/archetypes/index.html), die im Paket enthalten sind. Sie können einen bestimmten Archetyp zur Nutzung auswählen, indem Sie das Argument `-DarchetypeArtifactId` an den Befehl `archetype:generate` anhängen. Zum Beispiel: ``` mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DgroupId=org.example.webapp \ -DartifactId=mywebapp ``` **Anmerkung** [Viele weitere Informationen zum Erstellen und Konfigurieren von Projekten finden Sie im Maven-Handbuch „Erste Schritte“.](https://maven.apache.org/guides/getting-started/) ## Konfigurieren des SDKs als Maven-Abhängigkeit Um das AWS SDK für Java in Ihrem Projekt zu verwenden, müssen Sie es als Abhängigkeit in der `pom.xml` Datei Ihres Projekts deklarieren. Ab Version 1.9.0 können Sie [einzelne Komponenten](#configuring-maven-individual-components) oder das [gesamte SDK](#configuring-maven-entire-sdk) importieren. ### Angeben einzelner SDK-Module Verwenden Sie zur Auswahl einzelner SDK-Module die AWS SDK für Java Stückliste (BOM) für Maven. Dadurch wird sichergestellt, dass die von Ihnen angegebenen Module dieselbe Version des SDK verwenden und dass sie miteinander kompatibel sind. Um die BOM zu verwenden, fügen Sie der Datei `pom.xml` Ihrer Anwendung einen Abschnitt `` hinzu. Fügen Sie dabei `aws-java-sdk-bom` als Abhängigkeit hinzu und geben Sie die SDK-Version an, die Sie nutzen möchten: ``` com.amazonaws aws-java-sdk-bom 1.11.1000 pom import ``` [Die neueste Version der AWS SDK für Java Stückliste, die auf Maven Central verfügbar ist, finden Sie unter: com.amazonaws/. https://mvnrepository.com/artifact/ aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Auf dieser Seite können Sie auch sehen, welche von der BOM verwalteten Module (Abhängigkeiten) Sie im Abschnitt `` der Datei `pom.xml` Ihres Projekts einfügen können. Sie können jetzt einzelne Module aus dem SDK zur Nutzung in Ihrer Anwendung auswählen. Da Sie die SDK-Version bereits in der BOM deklariert haben, müssen Sie die Versionsnummer nicht mehr für jede Komponente angeben. ``` com.amazonaws aws-java-sdk-s3 com.amazonaws aws-java-sdk-dynamodb ``` Sie können auch in der nachlesen, welche Abhängigkeiten Sie * AWS-Codebeispiel-Katalog *für eine bestimmte Aufgabe verwenden sollten. AWS-Service Weitere Informationen finden Sie in der POM-Datei unter einem bestimmten Servicebeispiel. Wenn Sie beispielsweise an den Abhängigkeiten für den AWS S3-Dienst interessiert sind, finden Sie das [vollständige Beispiel](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) unter GitHub. (Schau dir den Pom under /java/example\$1code/s 3 an). ### Importieren aller SDK-Module Wenn Sie das *gesamte* SDK als Abhängigkeit aufnehmen möchten, verwenden Sie nicht die BOM-Methode. Deklarieren Sie es stattdessen einfach wie folgt in `pom.xml`: ``` com.amazonaws aws-java-sdk 1.11.1000 ``` ## Erstellen Ihres Projekts Sobald Ihr Projekt fertig eingerichtet ist, können Sie es mit dem Maven-Befehl `package` erstellen: ``` mvn package ``` Dadurch wird die `–0—jar`-Datei im Verzeichnis `target` angelegt. ## Erstellen des SDKs mit Maven Sie können Apache Maven verwenden, um das SDK aus den Quellen zu erstellen. Laden Sie dazu [den SDK-Code von herunter GitHub](https://github.com/aws/aws-sdk-java), entpacken Sie ihn lokal und führen Sie dann den folgenden Maven-Befehl aus: ``` mvn clean install ``` # Das SDK mit Gradle verwenden Um die SDK-Abhängigkeiten für Ihr [Gradle-Projekt](https://gradle.com/) zu verwalten, importieren Sie die Maven-Stückliste für AWS SDK für Java in die Datei der Anwendung. `build.gradle` **Anmerkung** Ersetzen Sie in den folgenden Beispielen *1.12.529* in der Build-Datei durch eine gültige Version von. AWS SDK für Java Suchen Sie die neueste Version im [zentralen Maven-Repository](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest). ## Projekteinrichtung für Gradle 4.6 oder höher [Seit Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import) können Sie die verbesserte POM-Unterstützungsfunktion von Gradle verwenden, um Stücklistendateien (BOM) zu importieren, indem Sie eine Abhängigkeit von einer Stückliste deklarieren. 1. Wenn Sie Gradle 5.0 oder höher verwenden, fahren Sie mit Schritt 2 fort. Andernfalls aktivieren Sie die Funktion *IMPROVED\$1POM\$1SUPPORT* in der `settings.gradle`-Datei. ``` enableFeaturePreview('IMPROVED_POM_SUPPORT') ``` 1. Fügen Sie die Stückliste zum Abschnitt *Abhängigkeiten der Anwendungsdatei* hinzu. `build.gradle` ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') // Declare individual SDK dependencies without version ... } ``` 1. Geben Sie im Abschnitt *dependencies (Abhängigkeiten)* die SDK-Module an, die verwendet werden sollen. Im Folgenden ist beispielsweise eine Abhängigkeit für Amazon Simple Storage Service (Amazon S3) enthalten. ``` ... dependencies { implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529') implementation 'com.amazonaws:aws-java-sdk-s3' ... } ``` Gradle löst mit den Informationen aus der BOM automatisch die richtige Version der SDK-Abhängigkeiten auf. Das Folgende ist ein Beispiel für eine vollständige `build.gradle` Datei, die eine Abhängigkeit für enthält 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' } ``` **Anmerkung** Ersetzen Sie im vorherigen Beispiel die Abhängigkeit von Amazon S3 durch die Abhängigkeiten der AWS Dienste, die Sie in Ihrem Projekt verwenden werden. Die Module (Abhängigkeiten), die von der AWS SDK für Java BOM verwaltet werden, sind im [zentralen Maven-Repository](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest) aufgeführt. ## Projekteinrichtung für Gradle-Versionen vor 4.6 Gradle-Versionen vor 4.6 verfügen über keine native Stücklistenunterstützung. Um AWS SDK für Java Abhängigkeiten für Ihr Projekt zu verwalten, verwenden Sie das [Abhängigkeitsverwaltungs-Plugin](https://github.com/spring-gradle-plugins/dependency-management-plugin) von Spring für Gradle, um die Maven-Stückliste für das SDK zu importieren. 1. Fügen Sie das Plugin für die Abhängigkeitsverwaltung zur Datei Ihrer Anwendung hinzu. `build.gradle` ``` buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE" } } apply plugin: "io.spring.dependency-management" ``` 1. Fügen Sie die BOM in den Abschnitt *dependencyManagement* der Datei ein. ``` dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529' } } ``` 1. Geben Sie im Abschnitt *Abhängigkeiten* die SDK-Module an, die Sie verwenden werden. Im folgenden Beispiel ist eine Abhängigkeit für Amazon S3 enthalten. ``` dependencies { compile 'com.amazonaws:aws-java-sdk-s3' } ``` Gradle löst mit den Informationen aus der BOM automatisch die richtige Version der SDK-Abhängigkeiten auf. Das Folgende ist ein Beispiel für eine vollständige `build.gradle` Datei, die eine Abhängigkeit für enthält 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' } ``` **Anmerkung** Ersetzen Sie im vorherigen Beispiel die Abhängigkeit von Amazon S3 durch die Abhängigkeiten des AWS Dienstes, den Sie in Ihrem Projekt verwenden werden. Die Module (Abhängigkeiten), die von der AWS SDK für Java BOM verwaltet werden, sind im [zentralen Maven-Repository](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest) aufgeführt. Weitere Informationen über das Angeben von SDK-Abhängigkeiten mit der BOM finden Sie unter [Verwenden des SDK mit Apache Maven](setup-project-maven.md). # AWS Temporäre Anmeldeinformationen und AWS-Region für die Entwicklung einrichten Um mit dem eine Verbindung zu einem der unterstützten Dienste herzustellen AWS SDK für Java, müssen Sie AWS temporäre Anmeldeinformationen angeben. Die AWS SDKs und CLIs verwenden *Anbieterketten*, um an verschiedenen Stellen nach AWS temporären Anmeldeinformationen zu suchen, einschließlich system/user Umgebungsvariablen und lokalen AWS Konfigurationsdateien. Dieses Thema enthält grundlegende Informationen zum Einrichten Ihrer AWS temporären Anmeldeinformationen für die lokale Anwendungsentwicklung mithilfe von AWS SDK für Java. Wenn Sie Anmeldeinformationen zur Nutzung innerhalb einer EC2-Instance einrichten möchten oder die Eclipse-IDE zur Entwicklung verwenden, sehen Sie sich stattdessen folgende Themen an: + Wenn Sie eine EC2-Instance verwenden, erstellen Sie eine IAM-Rolle und gewähren Sie dann Ihrer EC2-Instance Zugriff auf diese Rolle, wie unter [Using IAM Roles to Grant Access to Resources on beschrieben](java-dg-roles.md). AWS Amazon EC2 + Richten Sie AWS Anmeldeinformationen in Eclipse mit dem ein. [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/) Weitere Informationen finden Sie im [AWS Toolkit for Eclipse Benutzerhandbuch](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/) unter [AWS Anmeldeinformationen einrichten](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html). ## Konfigurieren Sie temporäre Anmeldeinformationen Sie können temporäre Anmeldeinformationen für AWS SDK für Java auf verschiedene Arten konfigurieren, aber hier sind die empfohlenen Vorgehensweisen: + Legen Sie temporäre Anmeldeinformationen in der Profildatei für AWS Anmeldeinformationen auf Ihrem lokalen System fest, die sich unter folgender Adresse befindet: + `~/.aws/credentials` (Linux, MacOS und Unix) + `C:\Users\USERNAME\.aws\credentials` (Windows) Anweisungen zum [Richten Sie temporäre Anmeldeinformationen für das SDK ein](signup-create-iam-user.md#setup-temp-creds) Abrufen Ihrer temporären Anmeldeinformationen finden Sie in diesem Handbuch. + Legen Sie die `AWS_SESSION_TOKEN` Umgebungsvariablen `AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY`, und fest. Um diese Variablen auf Linux, macOS oder Unix festzulegen, verwenden Sie : ``` 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 ``` In Windows können Sie die Variablen mit festlegen: ``` 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 ``` + Für eine EC2-Instance: Geben Sie eine IAM-Rolle an und gewähren Sie Ihrer EC2-Instance Zugriff auf diese Rolle. Eine ausführliche Beschreibung der Funktionsweise finden Sie unter [IAM-Rollen für Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) im Amazon EC2 Benutzerhandbuch für Linux-Instances. Sobald Sie Ihre AWS temporären Anmeldeinformationen mit einer dieser Methoden eingerichtet haben, werden sie automatisch AWS SDK für Java mithilfe der standardmäßigen Anmeldeinformationsanbieterkette geladen. Weitere Informationen zum Arbeiten mit AWS Anmeldeinformationen in Ihren Java-Anwendungen finden Sie unter [Mit AWS Anmeldeinformationen arbeiten](credentials.md). ## Aktualisieren von IMDS-Anmeldeinformationen Das AWS SDK für Java unterstützt die optionale Aktualisierung von IMDS-Anmeldeinformationen im Hintergrund alle 1 Minute, unabhängig von der Ablaufzeit der Anmeldeinformationen. Auf diese Weise können Sie Ihre Anmeldeinformationen häufiger aktualisieren und die Wahrscheinlichkeit verringern, dass die tatsächliche Verfügbarkeit beeinträchtigt wird, wenn Sie IMDS nicht erreichen. 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(); ``` ## Stellen Sie das ein AWS-Region Sie sollten einen Standard festlegen AWS-Region , der für den Zugriff auf AWS Dienste mit dem verwendet wird AWS SDK für Java. Um die beste Netzwerkleistung zu erzielen, wählen Sie die Region aus, die geografisch in Ihrer Nähe (oder in der Nähe Ihrer Kunden) liegt. Eine Liste der Regionen für jeden Dienst finden Sie unter [Regionen und Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html) in der Amazon Web Services allgemeinen Referenz. **Anmerkung** Wenn Sie *keine* Region auswählen, wird standardmäßig us-east-1 verwendet. Sie können ähnliche Techniken wie das Festlegen von Anmeldeinformationen verwenden, um Ihre AWS Standardregion festzulegen: + Stellen Sie das AWS-Region in der AWS Konfigurationsdatei auf Ihrem lokalen System ein, die sich unter folgendem Pfad befindet: + \$1/.aws/config unter Linux, macOS oder Unix + C:\$1Users\$1USERNAME\$1 .aws\$1 config unter Windows Diese Datei sollte Zeilen im folgenden Format enthalten: \$1 ``` [default] region = your_aws_region ``` \$1 *Ersetzen Sie AWS-Region your\$1aws\$1region durch Ihre gewünschte (z. B. „us-east-1").* + Legen Sie die `AWS_REGION`-Umgebungsvariable fest. Verwenden Sie unter Linux, macOS oder Unix **``**: ``` export AWS_REGION=your_aws_region ``` In Windows nutzen Sie ** `` **: ``` set AWS_REGION=your_aws_region ``` Wobei *your\$1aws\$1region der gewünschte Name* ist. AWS-Region