Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS STS Titik akhir regional
**catatan**
Untuk bantuan dalam memahami tata letak halaman pengaturan, atau dalam menafsirkan tabel **Support by AWS SDKs and tools** berikut, lihat[Memahami halaman pengaturan panduan ini](settings-reference.md#settingsPages).
AWS Security Token Service (AWS STS) tersedia baik sebagai layanan global maupun Regional. Beberapa AWS SDKs dan CLIs menggunakan endpoint layanan global (`https://sts.amazonaws.com`) secara default, sementara beberapa menggunakan endpoint layanan Regional ()`https://sts.{region_identifier}.{partition_domain}`. Di Wilayah yang [diaktifkan secara default](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html), permintaan ke titik akhir AWS STS global secara otomatis ditayangkan di Wilayah yang sama tempat permintaan berasal. Di Wilayah keikutsertaan, permintaan ke titik akhir AWS STS global dilayani oleh satu Wilayah AWS, US East (Virginia N.). Untuk informasi selengkapnya tentang AWS STS titik akhir, lihat [Titik Akhir](https://docs.aws.amazon.com/STS/latest/APIReference/welcome.html#sts-endpoints) di *Referensi AWS Security Token Service API* atau [Kelola AWS STSWilayah AWS dalam AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) *Panduan Pengguna*.
Ini adalah praktik AWS terbaik untuk menggunakan titik akhir Regional bila memungkinkan dan untuk mengkonfigurasi Anda[Wilayah AWS](feature-region.md). Pelanggan di [partisi](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html?id=docs_gateway#partition) selain komersial harus menggunakan titik akhir Regional. Tidak semua SDKs dan alat mendukung pengaturan ini, tetapi semua memiliki perilaku yang ditentukan di sekitar titik akhir global dan Regional. Lihat bagian berikut untuk informasi selengkapnya.
**catatan**
AWS telah membuat perubahan pada AWS Security Token Service (AWS STS) titik akhir global (`https://sts.amazonaws.com`) di Wilayah yang [diaktifkan secara default](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) untuk meningkatkan ketahanan dan kinerjanya. AWS STS permintaan ke titik akhir global secara otomatis disajikan Wilayah AWS sama dengan beban kerja Anda. Perubahan ini tidak akan diterapkan ke Wilayah keikutsertaan. Kami menyarankan Anda menggunakan titik akhir AWS STS regional yang sesuai. Untuk informasi selengkapnya, lihat [perubahan titik akhir AWS STS global](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_region-endpoints.html#reference_sts_global_endpoint_changes) di *Panduan AWS Identity and Access Management Pengguna*.
Untuk SDKs dan alat yang mendukung pengaturan ini, pelanggan dapat mengonfigurasi fungsionalitas dengan menggunakan yang berikut ini:
**`sts_regional_endpoints`- Pengaturan AWS `config` file bersama`AWS_STS_REGIONAL_ENDPOINTS`- variabel lingkungan**
Setelan ini menentukan cara SDK atau alat menentukan Layanan AWS titik akhir yang digunakannya untuk berbicara dengan (). AWS Security Token Service AWS STS
**Nilai default:**`regional`, lihat pengecualian dalam tabel berikut.
Semua versi utama SDK baru yang dirilis setelah Juli 2022 akan default ke. `regional` Versi utama SDK baru mungkin menghapus pengaturan ini dan menggunakan `regional` perilaku. Untuk mengurangi dampak masa depan terkait perubahan ini, kami sarankan Anda mulai menggunakan `regional` aplikasi Anda jika memungkinkan.
**Nilai yang valid:** *(Nilai yang disarankan:`regional`)*
+ **`legacy`**— Menggunakan AWS STS titik akhir global,`sts.amazonaws.com`.
+ **`regional`**- SDK atau alat selalu menggunakan AWS STS titik akhir untuk Wilayah yang saat ini dikonfigurasi. Misalnya, jika klien dikonfigurasi untuk digunakan`us-west-2`, semua panggilan ke AWS STS dilakukan ke titik akhir Regional`sts.us-west-2.amazonaws.com`, bukan titik `sts.amazonaws.com` akhir global. Untuk mengirim permintaan ke titik akhir global saat pengaturan ini diaktifkan, Anda dapat mengatur Wilayah ke`aws-global`.
Contoh pengaturan nilai-nilai ini dalam `config` file:
```
[default]
sts_regional_endpoints = regional
```
Linux/macOS contoh pengaturan variabel lingkungan melalui baris perintah:
```
export AWS_STS_REGIONAL_ENDPOINTS=regional
```
Contoh Windows pengaturan variabel lingkungan melalui baris perintah:
```
setx AWS_STS_REGIONAL_ENDPOINTS regional
```
## Support oleh AWS SDKs dan alat
**catatan**
Ini adalah praktik AWS terbaik untuk menggunakan titik akhir Regional bila memungkinkan dan untuk mengkonfigurasi Anda[Wilayah AWS](feature-region.md).
Tabel berikut ini merangkum, untuk SDK atau alat Anda:
+ **Mendukung pengaturan**: Apakah variabel `config` file bersama dan variabel lingkungan untuk titik akhir STS Regional didukung.
+ **Nilai pengaturan default**: Nilai default pengaturan jika didukung.
+ **Target klien layanan default STS Endpoint**: Titik akhir default apa yang digunakan oleh klien meskipun pengaturan untuk mengubahnya tidak tersedia.
+ **Perilaku fallback klien layanan**: Apa yang dilakukan SDK ketika seharusnya menggunakan titik akhir Regional tetapi tidak ada Wilayah yang dikonfigurasi. Ini adalah perilaku terlepas dari apakah itu menggunakan titik akhir Regional karena default atau karena `regional` telah dipilih oleh pengaturan.
Tabel ini juga menggunakan nilai-nilai berikut:
+ **Titik akhir global**:`https://sts.amazonaws.com`.
+ **Titik akhir regional**: Berdasarkan konfigurasi yang [Wilayah AWS](feature-region.md) digunakan oleh aplikasi Anda.
+ **`us-east-1`(Regional)**: Menggunakan titik akhir `us-east-1` Wilayah tetapi dengan token sesi yang lebih panjang daripada permintaan global biasa.
| SDK | Mendukung pengaturan | Nilai pengaturan default | Target klien layanan default STS Endpoint | Perilaku fallback klien layanan | Catatan atau informasi lebih lanjut |
| --- | --- | --- | --- | --- | --- |
| [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/) | Tidak | N/A | Titik akhir Regional | Titik akhir global | |
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Ya | legacy | Titik akhir global | Titik akhir global | |
| [SDK for C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Tidak | N/A | Titik akhir Regional | us-east-1(Regional) | |
| [SDK for Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Tidak | N/A | Titik akhir Regional | Kegagalan permintaan | |
| [SDK for Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Ya | legacy | Titik akhir global | Titik akhir global | Untuk menggunakan pengaturan config file bersama, Anda harus mengaktifkan pemuatan dari file konfigurasi; lihat [Sesi](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). |
| [SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Tidak | N/A | Titik akhir Regional | Kegagalan permintaan | Jika tidak ada Wilayah yang dikonfigurasi, `AssumeRole` dan `AssumeRoleWithWebIdentity` akan menggunakan titik akhir STS global. |
| [SDK for Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Ya | legacy | Titik akhir global | Titik akhir global | |
| [SDK untuk 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Tidak | N/A | Titik akhir Regional | us-east-1(Regional) | |
| [SDK untuk 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Ya | legacy | Titik akhir global | Titik akhir global | |
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Tidak | N/A | Titik akhir Regional | Titik akhir global | |
| [SDK for .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Tidak | N/A | Titik akhir Regional | us-east-1(Regional) | |
| [SDK for .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Ya | regional | Titik akhir global | Titik akhir global | |
| [SDK for PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Ya | regional | Titik akhir global | Kegagalan permintaan | |
| [SDK untuk Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Ya | regional | Titik akhir global | Titik akhir global | |
| [SDK for Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Ya | regional | Titik akhir Regional | Kegagalan permintaan | |
| [SDK untuk Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Tidak | N/A | Titik akhir Regional | Kegagalan permintaan | |
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Tidak | N/A | Titik akhir Regional | Kegagalan permintaan | |
| [Alat untuk PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Ya | regional | Titik akhir global | Titik akhir global | |
| [Alat untuk PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Ya | regional | Titik akhir global | Titik akhir global | |