Konfigurasikan AWS Wilayah - AWS SDK for .NET
Buat klien layanan dengan Wilayah tertentuTentukan Wilayah untuk semua klien layananResolusi wilayahInformasi khusus tentang Wilayah China (Beijing)Informasi khusus tentang AWS layanan baru

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

Konfigurasikan AWS Wilayah

AWSWilayah 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. Menyetel Wilayah dengan cara ini lebih diutamakan daripada pengaturan global apa pun untuk klien layanan tertentu.

Wilayah yang Ada

Contoh ini menunjukkan kepada Anda cara membuat instance klien Amazon EC2 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

Contoh ini menunjukkan kepada Anda bagaimana membangun titik akhir Region baru dengan menggunakan. RegionEndpoint GetBySystemName.

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 Amazonec2config.

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 for .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 SDK dan toolkit, bukan hanya file. AWS SDK for .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 menentukanWilayah AWS, AWS SDK for .NET upaya untuk menemukan Wilayah untuk klien AWS layanan untuk beroperasi.

Urutan resolusi wilayah

  1. File konfigurasi aplikasi seperti app.config danweb.config.

  2. Variabel lingkungan (AWS_REGIONdanAWS_DEFAULT_REGION).

  3. Profil dengan nama yang ditentukan oleh nilai diAWSConfigs.AWSProfileName.

  4. Profil dengan nama yang ditentukan oleh variabel AWS_PROFILE lingkungan.

  5. [default]Profil.

  6. Metadata instans Amazon EC2 (jika berjalan pada instans EC2).

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 China (Beijing)

Untuk menggunakan layanan di Wilayah China (Beijing), Anda harus memiliki akun dan kredensyal yang khusus untuk Wilayah China (Beijing). Akun dan kredensyal untuk AWS Wilayah lain tidak akan berfungsi untuk Wilayah China (Beijing). Demikian juga, akun dan kredensyal untuk Wilayah China (Beijing) tidak akan berfungsi untuk Wilayah lainAWS. Untuk informasi tentang titik akhir dan protokol yang tersedia di Wilayah China (Beijing), lihat Titik Akhir Wilayah Beijing.

Informasi khusus tentang AWS layanan baru

AWSLayanan 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.