Tentukan AWS Wilayah - AWS Tools for PowerShell
Mencantumkan Titik Akhir Kustom atau Tidak StandarInformasi tambahan

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

Tentukan AWS Wilayah

Ada dua cara untuk menentukan AWS Wilayah yang akan digunakan saat menjalankan AWS Tools for PowerShell perintah:

  • Menggunakan parameter umum -Region pada perintah individu.

  • Menggunakan perintah Set-DefaultAWSRegion untuk mengatur Wilayah default untuk semua perintah.

Banyak AWS cmdlet gagal jika Alat untuk Windows tidak PowerShell dapat mengetahui Wilayah apa yang akan digunakan. Pengecualian termasuk cmdlet untuk Amazon S3, Amazon SES, AWS Identity and Access Management dan, yang secara otomatis default ke titik akhir global.

Untuk menentukan wilayah untuk satu AWS perintah

Tambahkan parameter -Region ke perintah Anda, seperti ini.

PS > Get-EC2Image -Region us-west-2

Untuk mengatur wilayah default untuk semua perintah AWS CLI di sesi saat ini

Dari PowerShell command prompt, ketik perintah berikut.

PS > Set-DefaultAWSRegion -Region us-west-2
catatan

Pengaturan ini tetap berlanjut hanya untuk sesi saat ini. Untuk menerapkan pengaturan ke semua PowerShell sesi Anda, tambahkan perintah ini ke PowerShell profil Anda seperti yang Anda lakukan untuk Import-Module perintah.

Untuk melihat wilayah default saat ini untuk semua perintah AWS CLI

Dari PowerShell command prompt, ketik perintah berikut.

PS > Get-DefaultAWSRegion

Region    Name             IsShellDefault
------    ----             --------------
us-west-2 US West (Oregon) True

Untuk menghapus Wilayah default saat ini untuk semua perintah AWS CLI

Dari PowerShell command prompt, ketik perintah berikut.

PS > Clear-DefaultAWSRegion

Untuk melihat daftar semua AWS Wilayah yang tersedia

Dari PowerShell command prompt, ketik perintah berikut. Kolom ketiga dalam output sampel mengidentifikasi Wilayah mana yang merupakan default untuk sesi Anda saat ini.

PS > Get-AWSRegion

Region         Name                      IsShellDefault
------         ----                      --------------
ap-east-1      Asia Pacific (Hong Kong)  False
ap-northeast-1 Asia Pacific (Tokyo)      False
...
us-east-2      US East (Ohio)            False
us-west-1      US West (N. California)   False
us-west-2      US West (Oregon)          True
...
catatan

Beberapa Wilayah mungkin didukung tetapi tidak termasuk dalam output dari cmdlet Get-AWSRegion. Misalnya, hal ini terkadang berlaku untuk Wilayah yang belum global. Jika Anda tidak dapat menentukan Wilayah dengan menambahkan parameter -Region ke perintah, coba sebutkan Wilayah di titik akhir kustom sebagai gantinya, seperti yang ditunjukkan di bagian berikut.

Mencantumkan Titik Akhir Kustom atau Tidak Standar

Tentukan titik akhir kustom sebagai URL dengan menambahkan parameter -EndpointUrl umum ke PowerShell perintah Tools for Windows Anda, dalam format contoh berikut.

PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters

Berikut ini adalah sebuah contoh menggunakan cmdlet Get-EC2Instance. Titik akhir kustom ada di us-west-2, atau Wilayah US West (Oregon) dalam contoh ini, tetapi Anda dapat menggunakan Wilayah AWS yang didukung lainnya, termasuk wilayah yang tidak disebutkan oleh Get-AWSRegion.

PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"

Informasi tambahan

Untuk informasi tambahan tentang AWS Wilayah, lihat AWS Wilayah di AWS SDK dan Panduan Referensi Alat.