Wilayah AWS - AWS SDKs dan Tools

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Wilayah AWS

catatan

Untuk bantuan dalam memahami tata letak halaman pengaturan, atau dalam menafsirkan tabel Support by AWS SDKs and tools berikut, lihatMemahami halaman pengaturan panduan ini.

Wilayah AWS adalah konsep penting untuk dipahami ketika bekerja dengan Layanan AWS.

Dengan Wilayah AWS, Anda dapat mengakses Layanan AWS yang secara fisik berada di wilayah geografis tertentu. Ini dapat berguna untuk menjaga data dan aplikasi Anda berjalan dekat dengan tempat Anda dan pengguna Anda akan mengaksesnya. Wilayah memberikan toleransi kesalahan, stabilitas, serta ketahanan, dan juga dapat mengurangi latensi. Dengan Wilayah, Anda dapat membuat sumber daya redundan yang tetap tersedia dan tidak terpengaruh oleh pemadaman Regional.

Sebagian besar Layanan AWS permintaan dikaitkan dengan wilayah geografis tertentu. Sumber daya yang Anda buat di satu Wilayah tidak ada di Wilayah lain kecuali Anda secara eksplisit menggunakan fitur replikasi yang ditawarkan oleh. Layanan AWS Misalnya, Amazon S3 dan Amazon EC2 mendukung replikasi lintas wilayah. Beberapa layanan, seperti IAM, tidak memiliki sumber daya Regional.

Referensi Umum AWSBerisi informasi tentang hal berikut:

  • Untuk memahami hubungan antara Wilayah dan titik akhir, dan untuk melihat daftar titik akhir Regional yang ada, lihat titik akhir AWS layanan.

  • Untuk melihat daftar saat ini dari semua Wilayah dan titik akhir yang didukung untuk masing-masing Layanan AWS, lihat Titik akhir dan kuota layanan.

Membuat klien layanan

Untuk mengakses secara terprogram Layanan AWS, SDKs gunakan kelas/objek klien untuk masing-masing. Layanan AWS Jika aplikasi Anda perlu mengakses Amazon EC2, misalnya, aplikasi Anda akan membuat objek EC2 klien Amazon untuk berinteraksi dengan layanan itu.

Jika tidak ada Wilayah yang secara eksplisit ditentukan untuk klien dalam kode itu sendiri, klien default menggunakan Wilayah yang diatur melalui pengaturan berikut. region Namun, Region aktif untuk klien dapat secara eksplisit diatur untuk setiap objek klien individu. Menyetel Wilayah dengan cara ini lebih diutamakan daripada pengaturan global apa pun untuk klien layanan tertentu. Wilayah alternatif ditentukan selama instantiasi klien tersebut, khusus untuk SDK Anda (periksa Panduan SDK spesifik Anda atau basis kode SDK Anda).

Konfigurasikan fungsi ini dengan menggunakan yang berikut ini:

region- Pengaturan AWS config file bersama
AWS_REGION- variabel lingkungan
aws.region- Properti sistem JVM: Hanya Java/Kotlin

Menentukan default Wilayah AWS untuk digunakan untuk AWS permintaan. Wilayah ini digunakan untuk permintaan layanan SDK yang tidak disediakan dengan Wilayah tertentu untuk digunakan.

Nilai default: Tidak ada. Anda harus menentukan nilai ini secara eksplisit.

Nilai yang valid:

  • Setiap kode Wilayah yang tersedia untuk layanan yang dipilih, seperti yang tercantum dalam titik akhir AWS layanan dalam Referensi AWS Umum. Misalnya, nilai us-east-1 menetapkan titik akhir ke Timur Wilayah AWS AS (Virginia N.).

  • aws-globalmenentukan titik akhir global untuk layanan yang mendukung titik akhir global terpisah selain titik akhir Regional, seperti AWS Security Token Service ()AWS STS dan Amazon Simple Storage Service (Amazon S3).

Contoh pengaturan nilai ini dalam config file:

[default] region = us-west-2

Linux/macOS contoh pengaturan variabel lingkungan melalui baris perintah:

export AWS_REGION=us-west-2

Contoh Windows pengaturan variabel lingkungan melalui baris perintah:

setx AWS_REGION us-west-2

Sebagian besar SDKs memiliki objek “konfigurasi” yang tersedia untuk mengatur Wilayah default dari dalam kode aplikasi. Untuk detailnya, lihat panduan developer AWS SDK spesifik Anda.

Support oleh AWS SDKs dan alat

Berikut ini SDKs mendukung fitur dan pengaturan yang dijelaskan dalam topik ini. Setiap pengecualian sebagian dicatat. Setiap pengaturan properti sistem JVM didukung oleh AWS SDK for Java dan satu-satunya. AWS SDK for Kotlin

SDK Didukung Catatan atau informasi lebih lanjut
AWS CLI v2 Ya AWS CLI v2 menggunakan nilai apa pun AWS_REGION sebelum nilai apa pun di AWS_DEFAULT_REGION (kedua variabel diperiksa).
AWS CLI v1 Ya AWS CLI v1 menggunakan variabel lingkungan bernama AWS_DEFAULT_REGION untuk tujuan ini.
SDK for C++ Ya
SDK for Go V2 (1.x) Ya
SDK for Go 1.x (V1) Ya Untuk menggunakan pengaturan config file bersama, Anda harus mengaktifkan pemuatan dari file konfigurasi; lihat Sesi.
SDK for Java 2.x Ya
SDK for Java 1.x Ya
SDK untuk 3.x JavaScript Ya
SDK untuk 2.x JavaScript Ya
SDK para Kotlin Ya
SDK for .NET 3.x Ya
SDK for PHP 3.x Ya
SDK untuk Python (Boto3) Ya SDK ini menggunakan variabel lingkungan bernama AWS_DEFAULT_REGION untuk tujuan ini.
SDK for Ruby 3.x Ya
SDK untuk Rust Ya
SDK para Swift Ya
Alat untuk PowerShell Ya