AWS SDK untuk Java 1.x mencapai end-of-support pada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)untuk terus menerima fitur baru, peningkatan ketersediaan, dan pembaruan keamanan.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai
Bagian ini memberikan informasi tentang cara menginstal, mengatur, dan menggunakan AWS SDK untuk Java.
**Topics**
+ [Pengaturan dasar](signup-create-iam-user.md)
+ [
# Cara untuk mendapatkan AWS SDK untuk Java
](setup-install.md)
+ [
# Gunakan alat build
](setup-build-tools.md)
+ [Kredensyal sementara dan Wilayah](setup-credentials.md)
# Pengaturan dasar untuk bekerja dengan Layanan AWS
## Ikhtisar
Untuk berhasil mengembangkan aplikasi yang mengakses Layanan AWS menggunakan AWS SDK untuk Java, kondisi berikut diperlukan:
+ Anda harus dapat [masuk ke portal AWS akses](#setup-awsaccount) yang tersedia di AWS IAM Identity Center.
+ [Izin peran IAM yang](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) dikonfigurasi untuk SDK harus mengizinkan akses ke Layanan AWS yang dibutuhkan aplikasi Anda. Izin yang terkait dengan kebijakan **PowerUserAccess** AWS terkelola cukup untuk sebagian besar kebutuhan pengembangan.
+ Lingkungan pengembangan dengan elemen-elemen berikut:
+ [File konfigurasi bersama](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) yang diatur dengan cara berikut:
+ `config`File tersebut berisi profil default yang menentukan file Wilayah AWS.
+ `credentials`File berisi kredensi sementara sebagai bagian dari profil default.
+ [Instalasi Java yang](#java-dg-java-env) cocok.
+ [Alat otomatisasi build](setup-build-tools.md) [seperti [Maven](https://maven.apache.org/download.cgi) atau Gradle.](https://gradle.org/install/)
+ Editor teks untuk bekerja dengan kode.
+ (Opsional, tetapi disarankan) IDE (lingkungan pengembangan terintegrasi) seperti [IntelliJ](https://www.jetbrains.com/idea/download/#section=windows) IDEA[, Eclipse,](https://www.eclipse.org/ide/) atau. [NetBeans](https://netbeans.org/downloads/)
Saat Anda menggunakan IDE, Anda juga dapat mengintegrasikan AWS Toolkit s agar lebih mudah digunakan Layanan AWS. [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html)Ini adalah dua toolkit yang dapat Anda gunakan untuk pengembangan Java. [AWS Toolkit for IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)
**penting**
Petunjuk di bagian penyiapan ini mengasumsikan bahwa Anda atau organisasi menggunakan IAM Identity Center. Jika organisasi Anda menggunakan penyedia identitas eksternal yang bekerja secara independen dari IAM Identity Center, cari tahu bagaimana Anda bisa mendapatkan kredensi sementara untuk SDK for Java untuk digunakan. Ikuti [petunjuk ini](#setup-temp-creds) untuk menambahkan kredensi sementara ke file. `~/.aws/credentials`
Jika penyedia identitas Anda menambahkan kredensi sementara secara otomatis ke `~/.aws/credentials` file, pastikan bahwa nama profil tersebut `[default]` sehingga Anda tidak perlu memberikan nama profil ke SDK atau. AWS CLI
## Kemampuan masuk ke portal AWS akses
Portal AWS akses adalah lokasi web tempat Anda masuk secara manual ke Pusat Identitas IAM. Format URL adalah `d-xxxxxxxxxx.awsapps.com/start` atau`your_subdomain.awsapps.com/start`.
Jika Anda tidak terbiasa dengan portal AWS akses, ikuti panduan untuk akses akun di [Langkah 1 topik autentikasi Pusat Identitas IAM](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted) di Panduan Referensi Alat AWS SDKs dan Alat. Jangan ikuti Langkah 2 karena AWS SDK untuk Java 1.x tidak mendukung penyegaran token otomatis dan pengambilan otomatis kredenal sementara untuk SDK yang dijelaskan Langkah 2.
## Siapkan file konfigurasi bersama
File konfigurasi bersama berada di workstation pengembangan Anda dan berisi pengaturan dasar yang digunakan oleh semua AWS SDKs dan ( AWS Command Line Interface CLI). File konfigurasi bersama dapat berisi [sejumlah pengaturan](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html), tetapi instruksi ini mengatur elemen dasar yang diperlukan untuk bekerja dengan SDK.
### Siapkan `config` file bersama
Contoh berikut menunjukkan konten `config` file bersama.
```
[default]
region=us-east-1
output=json
```
Untuk tujuan pengembangan, gunakan yang Wilayah AWS [terdekat](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) dengan tempat Anda berencana untuk menjalankan kode Anda. Untuk [daftar kode wilayah](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes) yang akan digunakan dalam `config` file, lihat Referensi Umum Amazon Web panduan. `json`Pengaturan untuk format output adalah salah satu dari [beberapa nilai yang mungkin](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html).
Ikuti panduan [di bagian ini](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) untuk membuat `config` file.
### Menyiapkan kredensi sementara untuk SDK
Setelah Anda memiliki akses ke peran Akun AWS dan IAM melalui portal AWS akses, konfigurasikan lingkungan pengembangan Anda dengan kredensi sementara untuk diakses SDK.
**Langkah-langkah untuk mengatur `credentials` file lokal dengan kredensi sementara**
1. [Buat `credentials` file bersama](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html).
1. Dalam `credentials` file, rekatkan teks placeholder berikut hingga Anda menempelkan kredensi sementara yang berfungsi.
```
[default]
aws_access_key_id=
aws_secret_access_key=
aws_session_token=
```
1. Simpan file tersebut. File sekarang `~/.aws/credentials` harus ada di sistem pengembangan lokal Anda. File ini berisi [profil [default]](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) yang digunakan SDK for Java jika profil bernama tertentu tidak ditentukan.
1. [Masuk ke portal AWS akses](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html).
1. Ikuti petunjuk ini di bawah judul [penyegaran kredenal manual](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) untuk menyalin kredensi peran IAM dari portal akses. AWS
1. Untuk langkah 4 dalam petunjuk terkait, pilih nama peran IAM yang memberikan akses untuk kebutuhan pengembangan Anda. Peran ini biasanya memiliki nama seperti **PowerUserAccess**atau **Pengembang**.
1. Untuk langkah 7, pilih opsi **Tambahkan profil ke file AWS kredensial Anda secara manual** dan salin isinya.
1. Rekatkan kredensi yang disalin ke `credentials` file lokal Anda dan hapus nama profil apa pun yang ditempelkan. File Anda harus menyerupai yang berikut ini:
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
1. Simpan `credentials` file
SDK for Java akan mengakses kredensi sementara ini ketika membuat klien layanan dan menggunakannya untuk setiap permintaan. Pengaturan untuk peran IAM yang dipilih pada langkah 5a menentukan [berapa lama kredensi sementara valid](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html). Durasi maksimum adalah dua belas jam.
Setelah kredensi sementara kedaluwarsa, ulangi langkah 4 hingga 7.
## Instal Lingkungan Pengembangan Java
AWS SDK untuk Java V1 membutuhkan Java 7 JDK atau yang lebih baru dan semua Java LTS (dukungan jangka panjang) versi JDK didukung. Jika Anda menggunakan SDK versi 1.12.767 atau lebih lama, Anda dapat menggunakan Java 7, tetapi jika Anda menggunakan SDK versi 1.12.768 atau yang lebih baru, Java 8 diperlukan. [Repositori pusat Maven](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom) mencantumkan versi terbaru SDK for Java.
[https://developers.redhat.com/products/openjdk/overview](https://developers.redhat.com/products/openjdk/overview)
# Cara untuk mendapatkan AWS SDK untuk Java
## Prasyarat
Untuk menggunakan AWS SDK untuk Java, Anda harus memiliki:
+ Anda harus dapat [masuk ke portal AWS akses](signup-create-iam-user.md#setup-awsaccount) yang tersedia di AWS IAM Identity Center.
+ [Instalasi Java yang](signup-create-iam-user.md#java-dg-java-env) cocok.
+ Kredensi sementara disiapkan di file bersama `credentials` lokal Anda.
Lihat [Pengaturan dasar untuk bekerja dengan Layanan AWS](signup-create-iam-user.md) topik untuk petunjuk tentang cara menyiapkan untuk menggunakan SDK for Java.
## Gunakan alat build untuk mengelola dependensi SDK for Java (disarankan)
Sebaiknya gunakan Apache Maven atau Gradle dengan project Anda untuk mengakses dependensi SDK for Java yang diperlukan. [ Bagian ini](setup-build-tools.md) menjelaskan cara menggunakan alat-alat tersebut.
## Unduh dan ekstrak SDK (tidak disarankan)
Kami menyarankan Anda menggunakan alat build untuk mengakses SDK untuk proyek Anda. Namun, Anda dapat mengunduh toples bawaan SDK versi terbaru.
**catatan**
Untuk selengkapnya tentang cara mengunduh dan membuat versi SDK sebelumnya, lihat [Menginstal SDK versi sebelumnya](#install-prev-sdk).
1. Unduh SDK [https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdkdari.zip.](https://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip)
1. Setelah mengunduh SDK, ekstrak konten ke direktori lokal.
SDK berisi direktori berikut:
+ `documentation`- berisi dokumentasi API (juga tersedia di web: [Referensi AWS SDK untuk Java API](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/)).
+ `lib`- berisi `.jar` file SDK.
+ `samples`- berisi kode contoh kerja yang menunjukkan cara menggunakan SDK.
+ `third-party/lib`- berisi pustaka pihak ketiga yang digunakan oleh SDK, seperti Apache commons logging, aspectJ dan framework Spring.
Untuk menggunakan SDK, tambahkan path lengkap ke `third-party` direktori `lib` dan ke dependensi dalam file build Anda, dan tambahkan ke java `CLASSPATH` Anda untuk menjalankan kode Anda.
## Buat versi SDK sebelumnya dari sumber (tidak disarankan)
Hanya versi terbaru dari SDK lengkap yang disediakan dalam bentuk pra-bangun sebagai toples yang dapat diunduh. Namun, Anda dapat membangun versi SDK sebelumnya menggunakan Apache Maven (open source). Maven akan mengunduh semua dependensi yang diperlukan, membangun dan menginstal SDK dalam satu langkah. Kunjungi [http://maven.apache.org/](http://maven.apache.org/) untuk petunjuk instalasi dan informasi lebih lanjut.
1. Buka GitHub halaman SDK di: [AWS SDK untuk Java (GitHub)](https://github.com/aws/aws-sdk-java).
1. Pilih tag yang sesuai dengan nomor versi SDK yang Anda inginkan. Misalnya, `1.6.10`.
1. Klik tombol **Unduh ZIP** untuk mengunduh versi SDK yang Anda pilih.
1. Buka zip file ke direktori di sistem pengembangan Anda. Pada banyak sistem, Anda dapat menggunakan manajer file grafis Anda untuk melakukan ini, atau menggunakan `unzip` utilitas di jendela terminal.
1. Di jendela terminal, arahkan ke direktori tempat Anda membuka ritsleting sumber SDK.
1. Bangun dan instal SDK dengan perintah berikut (diperlukan [Maven](https://maven.apache.org/)):
```
mvn clean install -Dgpg.skip=true
```
`.jar`File yang dihasilkan dibangun ke dalam `target` direktori.
1. (Opsional) Buat dokumentasi Referensi API menggunakan perintah berikut:
```
mvn javadoc:javadoc
```
Dokumentasi dibangun ke dalam `target/site/apidocs/` direktori.
# Gunakan alat build
Penggunaan alat build membantu mengelola pengembangan proyek Java. Beberapa alat build tersedia, tetapi kami menunjukkan cara memulai dan menjalankan dengan dua alat build populer - Maven dan Gradle. Topik ini menunjukkan cara menggunakan alat build ini untuk mengelola dependensi SDK for Java yang Anda perlukan untuk proyek Anda.
**Topics**
+ [
# Gunakan SDK dengan Apache Maven
](setup-project-maven.md)
+ [
# Menggunakan SDK dengan Gradle
](setup-project-gradle.md)
# Gunakan SDK dengan Apache Maven
Anda dapat menggunakan [Apache Maven](https://maven.apache.org/) untuk mengkonfigurasi dan membangun AWS SDK untuk Java proyek, atau untuk membangun SDK itu sendiri.
**catatan**
Anda harus menginstal Maven untuk menggunakan panduan dalam topik ini. Jika belum diinstal, kunjungi [http://maven.apache.org/](http://maven.apache.org/) untuk mengunduh dan menginstalnya.
## Buat paket Maven baru
Untuk membuat paket Maven dasar, buka jendela terminal (baris perintah) dan jalankan:
```
mvn -B archetype:generate \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DgroupId=org.example.basicapp \
-DartifactId=myapp
```
Ganti *org.example.basicapp* dengan namespace paket lengkap aplikasi Anda, dan *myapp* dengan nama proyek Anda (ini akan menjadi nama direktori untuk proyek Anda).
Secara default, buat template proyek untuk Anda menggunakan pola dasar [quickstart](http://maven.apache.org/archetypes/maven-archetype-quickstart/), yang merupakan tempat awal yang baik untuk banyak proyek. Ada lebih banyak arketipe yang tersedia; kunjungi halaman arketipe [Maven untuk daftar arketipe](https://maven.apache.org/archetypes/index.html) yang dikemas. Anda dapat memilih pola dasar tertentu untuk digunakan dengan menambahkan `-DarchetypeArtifactId` argumen ke perintah. `archetype:generate` Sebagai contoh:
```
mvn archetype:generate \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DarchetypeArtifactId=maven-archetype-webapp \
-DgroupId=org.example.webapp \
-DartifactId=mywebapp
```
**catatan**
Lebih banyak informasi tentang membuat dan mengonfigurasi proyek disediakan di Panduan [Memulai Maven](https://maven.apache.org/guides/getting-started/).
## Konfigurasikan SDK sebagai dependensi Maven
Untuk menggunakan AWS SDK untuk Java dalam proyek Anda, Anda harus mendeklarasikannya sebagai dependensi dalam file proyek Anda. `pom.xml` Dimulai dengan versi 1.9.0, Anda dapat mengimpor [komponen individual](#configuring-maven-individual-components) atau [seluruh](#configuring-maven-entire-sdk) SDK.
### Menentukan modul SDK individu
Untuk memilih modul SDK individual, gunakan AWS SDK untuk Java bill of materials (BOM) untuk Maven, yang akan memastikan bahwa modul yang Anda tentukan menggunakan versi SDK yang sama dan kompatibel satu sama lain.
Untuk menggunakan BOM, tambahkan `` bagian ke `pom.xml` file aplikasi Anda, tambahkan `aws-java-sdk-bom` sebagai dependensi dan tentukan versi SDK yang ingin Anda gunakan:
```
com.amazonaws
aws-java-sdk-bom
1.11.1000
pom
import
```
[Untuk melihat AWS SDK untuk Java BOM versi terbaru yang tersedia di Maven Central, kunjungi: https://mvnrepository.com/artifact/ com.amazonaws/. aws-java-sdk-bom](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom) Anda juga dapat menggunakan halaman ini untuk melihat modul (dependensi) mana yang dikelola oleh BOM yang dapat Anda sertakan dalam `` bagian file proyek Anda. `pom.xml`
Anda sekarang dapat memilih modul individual dari SDK yang Anda gunakan dalam aplikasi Anda. Karena Anda sudah mendeklarasikan versi SDK di BOM, Anda tidak perlu menentukan nomor versi untuk setiap komponen.
```
com.amazonaws
aws-java-sdk-s3
com.amazonaws
aws-java-sdk-dynamodb
```
Anda juga dapat merujuk ke * Katalog Kode Sampel AWS *untuk mempelajari dependensi apa yang akan digunakan untuk diberikan. Layanan AWS Lihat file POM di bawah contoh layanan tertentu. Misalnya, jika Anda tertarik dengan dependensi untuk layanan AWS S3, lihat contoh [lengkapnya](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/s3/src/main/java/aws/example/s3/GetAcl.java) di. GitHub (Lihat pom under /java/example\$1code/s 3).
### Mengimpor semua modul SDK
Jika Anda ingin menarik *seluruh* SDK sebagai dependensi, jangan gunakan metode BOM, tetapi cukup deklarasikan seperti ini: `pom.xml`
```
com.amazonaws
aws-java-sdk
1.11.1000
```
## Bangun proyek Anda
Setelah Anda menyiapkan proyek, Anda dapat membangunnya menggunakan perintah Maven: `package`
```
mvn package
```
Ini akan membuat `0jar` file Anda di `target` direktori.
## Membangun SDK dengan Maven
Anda dapat menggunakan Apache Maven untuk membangun SDK dari sumber. Untuk melakukannya, [unduh kode SDK dari GitHub](https://github.com/aws/aws-sdk-java), buka kemasannya secara lokal, lalu jalankan perintah Maven berikut:
```
mvn clean install
```
# Menggunakan SDK dengan Gradle
Untuk mengelola dependensi SDK untuk proyek [Gradle](https://gradle.com/) Anda, impor BOM Maven ke dalam AWS SDK untuk Java file aplikasi. `build.gradle`
**catatan**
Dalam contoh berikut, ganti *1.12.529* dalam file build dengan versi yang valid dari file AWS SDK untuk Java. Temukan versi terbaru di repositori [pusat Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).
## Penyiapan proyek untuk Gradle 4.6 atau lebih tinggi
[Sejak Gradle 4.6](https://docs.gradle.org/4.6/release-notes.html#bom-import), Anda dapat menggunakan fitur dukungan POM Gradle yang ditingkatkan untuk mengimpor file bill of materials (BOM) dengan mendeklarasikan dependensi pada BOM.
1. Jika Anda menggunakan Gradle 5.0 atau yang lebih baru, lewati ke langkah 2. Jika tidak, aktifkan fitur *IMPROVED\$1POM\$1SUPPORT* dalam file. `settings.gradle`
```
enableFeaturePreview('IMPROVED_POM_SUPPORT')
```
1. Tambahkan BOM ke bagian *dependensi* dari file aplikasi. `build.gradle`
```
...
dependencies {
implementation platform('com.amazonaws:aws-java-sdk-bom:1.12.529')
// Declare individual SDK dependencies without version
...
}
```
1. Tentukan modul SDK yang akan digunakan di bagian *dependensi*. Misalnya, berikut ini mencakup ketergantungan untuk 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 secara otomatis menyelesaikan versi dependensi SDK yang benar dengan menggunakan informasi dari BOM.
Berikut ini adalah contoh `build.gradle` file lengkap yang menyertakan ketergantungan untuk 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'
}
```
**catatan**
Pada contoh sebelumnya, ganti dependensi Amazon S3 dengan dependensi AWS layanan yang akan Anda gunakan dalam proyek Anda. Modul (dependensi) yang dikelola oleh AWS SDK untuk Java BOM terdaftar di repositori pusat [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).
## Penyiapan proyek untuk versi Gradle lebih awal dari 4.6
Versi Gradle lebih awal dari 4.6 tidak memiliki dukungan BOM asli. Untuk mengelola AWS SDK untuk Java dependensi proyek Anda, gunakan [plugin manajemen dependensi](https://github.com/spring-gradle-plugins/dependency-management-plugin) Spring untuk Gradle untuk mengimpor Maven BOM untuk SDK.
1. Tambahkan plugin manajemen ketergantungan ke `build.gradle` file aplikasi Anda.
```
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath "io.spring.gradle:dependency-management-plugin:1.0.9.RELEASE"
}
}
apply plugin: "io.spring.dependency-management"
```
1. Tambahkan BOM ke bagian *DependencyManagement* dari file.
```
dependencyManagement {
imports {
mavenBom 'com.amazonaws:aws-java-sdk-bom:1.12.529'
}
}
```
1. Tentukan modul SDK yang akan Anda gunakan di bagian *dependensi*. Misalnya, berikut ini mencakup ketergantungan untuk Amazon S3.
```
dependencies {
compile 'com.amazonaws:aws-java-sdk-s3'
}
```
Gradle secara otomatis menyelesaikan versi dependensi SDK yang benar dengan menggunakan informasi dari BOM.
Berikut ini adalah contoh `build.gradle` file lengkap yang menyertakan ketergantungan untuk 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'
}
```
**catatan**
Pada contoh sebelumnya, ganti dependensi Amazon S3 dengan dependensi AWS layanan yang akan Anda gunakan dalam proyek Anda. Modul (dependensi) yang dikelola oleh AWS SDK untuk Java BOM terdaftar di repositori pusat [Maven](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom/latest).
Untuk informasi selengkapnya tentang menentukan dependensi SDK dengan menggunakan BOM, lihat [Menggunakan SDK dengan Apache Maven](setup-project-maven.md).
# Menyiapkan kredensyal AWS sementara dan untuk pengembangan Wilayah AWS
Untuk terhubung ke salah satu layanan yang didukung dengan AWS SDK untuk Java, Anda harus memberikan kredensyal AWS sementara. *Rantai penyedia AWS SDKs * dan CLIs gunakan untuk mencari kredensyal AWS sementara di sejumlah tempat berbeda, termasuk variabel system/user lingkungan dan file AWS konfigurasi lokal.
Topik ini memberikan informasi dasar tentang pengaturan kredensyal AWS sementara Anda untuk pengembangan aplikasi lokal menggunakan. AWS SDK untuk Java Jika Anda perlu menyiapkan kredensyal untuk digunakan dalam instans EC2 atau jika Anda menggunakan Eclipse IDE untuk pengembangan, lihat topik berikut sebagai gantinya:
+ Saat menggunakan instans EC2, buat peran IAM dan kemudian berikan akses instans EC2 Anda ke peran tersebut seperti yang ditunjukkan dalam [Menggunakan Peran IAM untuk Memberikan Akses ke Sumber Daya aktif](java-dg-roles.md). AWS Amazon EC2
+ Siapkan AWS kredensyal dalam Eclipse menggunakan file. [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/) Lihat [Menyiapkan AWS Kredensyal](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/setup-credentials.html) di [Panduan AWS Toolkit for Eclipse Pengguna](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/) untuk informasi selengkapnya.
## Konfigurasikan kredensyal sementara
Anda dapat mengonfigurasi kredensyal sementara untuk AWS SDK untuk Java dalam beberapa cara, tetapi berikut adalah pendekatan yang disarankan:
+ Tetapkan kredensyal sementara di file profil AWS kredensial di sistem lokal Anda, yang terletak di:
+ `~/.aws/credentials`di Linux, macOS, atau Unix
+ `C:\Users\USERNAME\.aws\credentials` di Windows
Lihat [Menyiapkan kredensi sementara untuk SDK](signup-create-iam-user.md#setup-temp-creds) di panduan ini untuk petunjuk tentang cara mendapatkan kredensyal sementara Anda.
+ Mengatur`AWS_ACCESS_KEY_ID`,`AWS_SECRET_ACCESS_KEY`, dan variabel `AWS_SESSION_TOKEN` lingkungan.
Untuk mengatur variabel ini di Linux, macOS, atau Unix, gunakan :
```
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
```
Untuk menetapkan variabel ini di Windows, gunakan :
```
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
```
+ Untuk instans EC2, tentukan peran IAM dan kemudian berikan akses instans EC2 Anda ke peran itu. Lihat [Peran IAM untuk Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) di Panduan Amazon EC2 Pengguna untuk Instans Linux untuk diskusi mendetail tentang cara kerjanya.
Setelah Anda menetapkan kredensyal AWS sementara Anda menggunakan salah satu metode ini, mereka akan dimuat secara otomatis oleh dengan menggunakan rantai AWS SDK untuk Java penyedia kredensi default. Untuk informasi lebih lanjut tentang bekerja dengan AWS kredensyal di aplikasi Java Anda, lihat [Bekerja dengan AWS](credentials.md) Kredensyal.
## Menyegarkan kredensyal IMDS
AWS SDK untuk Java Dukungan opt-in menyegarkan kredensyal IMDS di latar belakang setiap 1 menit, terlepas dari waktu kedaluwarsa kredensialnya. Ini memungkinkan Anda untuk menyegarkan kredensyal lebih sering dan mengurangi kemungkinan bahwa tidak mencapai IMDS memengaruhi ketersediaan yang dirasakan. 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();
```
## Mengatur Wilayah AWS
Anda harus menetapkan default Wilayah AWS yang akan digunakan untuk mengakses AWS layanan dengan. AWS SDK untuk Java Untuk kinerja jaringan terbaik, pilih wilayah yang secara geografis dekat dengan Anda (atau dengan pelanggan Anda). Untuk daftar wilayah untuk setiap layanan, lihat [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html) di Referensi Amazon Web Services Umum.
**catatan**
Jika Anda *tidak* memilih wilayah, maka us-east-1 akan digunakan secara default.
Anda dapat menggunakan teknik serupa untuk menyetel kredensyal untuk menyetel wilayah default AWS Anda:
+ Setel file AWS konfigurasi Wilayah AWS di sistem lokal Anda, yang terletak di:
+ \$1/.aws/config di Linux, macOS, atau Unix
+ C:\$1Users\$1USERNAME\$1 .aws\$1 config pada Windows
File ini harus berisi baris dalam format berikut:
\$1
```
[default]
region = your_aws_region
```
\$1
*Gantikan yang Anda inginkan Wilayah AWS (misalnya, “us-east-1") untuk your\$1aws\$1region.*
+ Mengatur variabel `AWS_REGION` lingkungan.
Di Linux, macOS, atau Unix, gunakan: **``**
```
export AWS_REGION=your_aws_region
```
Di Windows, gunakan **``**:
```
set AWS_REGION=your_aws_region
```
Dimana *your\$1aws\$1region* adalah nama yang diinginkan. Wilayah AWS