Versi 4 (V4) dari dalam SDK untuk .NET pratinjau! Untuk melihat informasi tentang versi baru ini di pratinjau, lihat Panduan Pengembang AWS SDK untuk .NET (pratinjau versi 4).
Harap dicatat bahwa V4 SDK dalam pratinjau, oleh karena itu kontennya dapat berubah.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Konfigurasikan AWS Wilayah
AWS Wilayah memungkinkan Anda mengakses AWS layanan yang secara fisik berada di wilayah geografis tertentu. Ini dapat berguna untuk redundansi dan untuk menjaga data dan aplikasi Anda berjalan dekat dengan tempat Anda dan pengguna Anda akan mengaksesnya.
Untuk melihat daftar saat ini dari semua Wilayah dan titik akhir yang didukung untuk setiap AWS layanan, lihat Titik akhir dan kuota layanan di. Referensi Umum AWS Untuk melihat daftar titik akhir Regional yang ada, lihat titik akhir AWS layanan. Untuk melihat informasi terperinci tentang Wilayah, lihat Menentukan AWS Wilayah mana yang dapat digunakan akun Anda.
Anda dapat membuat klien AWS layanan yang masuk ke Wilayah tertentu. Anda juga dapat mengonfigurasi aplikasi Anda dengan Wilayah yang akan digunakan untuk semua klien AWS layanan. Kedua kasus ini dijelaskan selanjutnya.
Buat klien layanan dengan Wilayah tertentu
Anda dapat menentukan Wilayah untuk salah satu klien AWS layanan dalam aplikasi Anda. Mengatur Wilayah dengan cara ini lebih diutamakan daripada pengaturan global apa pun untuk klien layanan tertentu.
Wilayah yang Ada
Contoh ini menunjukkan cara membuat instance EC2 klien Amazon di Wilayah yang ada. Ini menggunakan RegionEndpointbidang yang ditentukan.
using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2))
{
// Make a request to EC2 in the us-west-2 Region using ec2Client
}
Wilayah Baru menggunakan RegionEndpoint kelas
var newRegion = RegionEndpoint.GetBySystemName("us-west-new");
using (var ec2Client = new AmazonEC2Client(newRegion))
{
// Make a request to EC2 in the new Region using ec2Client
}
Wilayah Baru menggunakan kelas konfigurasi klien layanan
Contoh ini menunjukkan cara menggunakan ServiceURL
properti kelas konfigurasi klien layanan untuk menentukan Wilayah; dalam hal ini, menggunakan kelas Amazon EC2 Config.
Teknik ini berfungsi bahkan jika titik akhir Wilayah tidak mengikuti pola titik akhir Wilayah biasa.
var ec2ClientConfig = new AmazonEC2Config
{
// Specify the endpoint explicitly
ServiceURL = "https://ec2.us-west-new.amazonaws.com"
};
using (var ec2Client = new AmazonEC2Client(ec2ClientConfig))
{
// Make a request to EC2 in the new Region using ec2Client
}
Tentukan Wilayah untuk semua klien layanan
Ada beberapa cara Anda dapat menentukan Wilayah untuk semua klien AWS layanan yang dibuat aplikasi Anda. Wilayah ini digunakan untuk klien layanan yang tidak dibuat dengan Wilayah tertentu.
Mencari AWS SDK untuk .NET nilai Region dalam urutan berikut.
Profil
Setel di profil yang telah dimuat aplikasi atau SDK Anda. Untuk informasi selengkapnya, lihat Resolusi kredensi dan profil.
Variabel-variabel lingkungan
Ditetapkan dalam variabel AWS_REGION
lingkungan.
Di Linux atau macOS:
export AWS_REGION='us-west-2'
Di Windows:
set AWS_REGION=us-west-2
catatan
Jika Anda menyetel variabel lingkungan ini untuk seluruh sistem (menggunakan export
atausetx
), itu memengaruhi semua SDKs dan toolkit, bukan hanya. SDK untuk .NET
AWSConfigs kelas
Tetapkan sebagai AWSConfigs. AWSRegionproperti.
AWSConfigs.AWSRegion = "us-west-2";
using (var ec2Client = new AmazonEC2Client())
{
// Make request to Amazon EC2 in us-west-2 Region using ec2Client
}
Resolusi wilayah
Jika tidak ada metode yang dijelaskan di atas yang digunakan untuk menentukan Wilayah AWS, SDK untuk .NET upaya untuk menemukan Wilayah untuk klien AWS layanan untuk beroperasi.
Urutan resolusi wilayah
-
File konfigurasi aplikasi seperti
app.config
danweb.config
. -
Variabel lingkungan (
AWS_REGION
danAWS_DEFAULT_REGION
). -
Profil dengan nama yang ditentukan oleh nilai di
AWSConfigs.AWSProfileName
. -
Profil dengan nama yang ditentukan oleh variabel
AWS_PROFILE
lingkungan. -
[default]
Profil. -
Metadata EC2 instans Amazon (jika berjalan pada sebuah EC2 instance).
Jika tidak ada Region yang ditemukan, SDK akan menampilkan pengecualian yang menyatakan bahwa klien AWS layanan tidak memiliki Region yang dikonfigurasi.
Informasi khusus tentang Wilayah Tiongkok (Beijing)
Untuk menggunakan layanan di Wilayah Tiongkok (Beijing), Anda harus memiliki akun dan kredensyal yang khusus untuk Wilayah Tiongkok (Beijing). Akun dan kredensyal untuk AWS Wilayah lain tidak akan berfungsi untuk Wilayah Tiongkok (Beijing). Demikian juga, akun dan kredensyal untuk Wilayah Tiongkok (Beijing) tidak akan berfungsi untuk Wilayah lain. AWS Untuk informasi tentang titik akhir dan protokol yang tersedia di Wilayah Tiongkok (Beijing), lihat Titik Akhir Wilayah Beijing.
Informasi khusus tentang AWS layanan baru
AWS Layanan baru dapat diluncurkan pada awalnya di beberapa Wilayah dan kemudian didukung di Wilayah lain. Dalam kasus ini, Anda tidak perlu menginstal SDK terbaru untuk mengakses Wilayah baru untuk layanan tersebut. Anda dapat menentukan Wilayah yang baru ditambahkan berdasarkan per klien atau secara global, seperti yang ditunjukkan sebelumnya.