Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Titik akhir khusus layanan
**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).
Konfigurasi titik akhir khusus layanan menyediakan opsi untuk menggunakan titik akhir yang Anda pilih untuk permintaan API dan agar pilihan itu tetap ada. Pengaturan ini memberikan fleksibilitas untuk mendukung titik akhir lokal, titik akhir VPC, dan lingkungan pengembangan lokal pihak ketiga AWS . Titik akhir yang berbeda dapat digunakan untuk lingkungan pengujian dan produksi. Anda dapat menentukan URL endpoint untuk individu Layanan AWS.
Konfigurasikan fungsi ini dengan menggunakan yang berikut:
**`endpoint_url`- Pengaturan AWS `config` file bersama`AWS_ENDPOINT_URL`- variabel lingkungan`aws.endpointUrl`- Properti sistem JVM: hanya Java/Kotlin **
Ketika ditentukan langsung dalam profil atau sebagai variabel lingkungan, pengaturan ini menentukan titik akhir yang digunakan untuk semua permintaan layanan. Titik akhir ini diganti oleh titik akhir khusus layanan yang dikonfigurasi.
Anda juga dapat menggunakan pengaturan ini dalam `services` bagian AWS `config` file bersama untuk menetapkan titik akhir kustom untuk layanan tertentu. Untuk daftar semua kunci pengenal layanan yang akan digunakan untuk subbagian dalam `services` bagian, lihat. [Pengidentifikasi untuk titik akhir khusus layanan](ss-endpoints-table.md)
**Nilai default:** `none`
**Nilai yang valid:** URL termasuk skema dan host untuk titik akhir. URL secara opsional dapat berisi komponen jalur yang berisi satu atau beberapa segmen jalur.
**`AWS_ENDPOINT_URL_`- variabel lingkungan`aws.endpointUrl`- Properti sistem JVM: hanya Java/Kotlin **
`AWS_ENDPOINT_URL_`, di `` mana Layanan AWS pengenal, menetapkan titik akhir khusus untuk layanan tertentu. Untuk daftar semua variabel lingkungan khusus layanan, lihat. [Pengidentifikasi untuk titik akhir khusus layanan](ss-endpoints-table.md)
Titik akhir khusus layanan ini mengesampingkan titik akhir global apa pun yang ditetapkan. `AWS_ENDPOINT_URL`
**Nilai default:** `none`
**Nilai yang valid:** URL termasuk skema dan host untuk titik akhir. URL secara opsional dapat berisi komponen jalur yang berisi satu atau beberapa segmen jalur.
**`ignore_configured_endpoint_urls`- Pengaturan AWS `config` file bersama`AWS_IGNORE_CONFIGURED_ENDPOINT_URLS`- variabel lingkungan`aws.ignoreConfiguredEndpointUrls`- Properti sistem JVM: hanya Java/Kotlin **
Pengaturan ini digunakan untuk mengabaikan semua konfigurasi titik akhir kustom.
Perhatikan bahwa setiap titik akhir eksplisit yang ditetapkan dalam kode atau pada klien layanan itu sendiri digunakan terlepas dari pengaturan ini. Misalnya, menyertakan parameter baris `--endpoint-url` perintah dengan AWS CLI perintah atau meneruskan URL titik akhir ke konstruktor klien akan selalu berlaku.
**Nilai default:** `false`
**Nilai yang valid:**
+ **`true`**SDK atau alat tidak membaca opsi konfigurasi khusus apa pun dari `config` file bersama atau dari variabel lingkungan untuk menyetel URL titik akhir.
+ **`false`**SDK atau alat menggunakan titik akhir yang disediakan pengguna yang tersedia dari `config` file bersama atau dari variabel lingkungan.
## Konfigurasikan titik akhir menggunakan variabel lingkungan
Untuk merutekan permintaan semua layanan ke URL titik akhir kustom, setel variabel lingkungan `AWS_ENDPOINT_URL` global.
```
export AWS_ENDPOINT_URL={{http://localhost:4567}}
```
Untuk merutekan permintaan spesifik Layanan AWS ke URL titik akhir kustom, gunakan variabel `AWS_ENDPOINT_URL_` lingkungan. Amazon DynamoDB memiliki `serviceId` dari [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/dynamodb/2012-08-10/service-2.json#L10](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/dynamodb/2012-08-10/service-2.json#L10). Untuk layanan ini, variabel lingkungan URL endpoint adalah`AWS_ENDPOINT_URL_DYNAMODB`. Titik akhir ini lebih diutamakan daripada titik akhir global yang ditetapkan untuk layanan ini. `AWS_ENDPOINT_URL`
```
export AWS_ENDPOINT_URL_DYNAMODB={{http://localhost:5678}}
```
Sebagai contoh lain, AWS Elastic Beanstalk memiliki `serviceId` a [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9). Layanan AWS Pengenal didasarkan pada model API `serviceId` dengan mengganti semua spasi dengan garis bawah dan huruf atas semua huruf. Untuk mengatur titik akhir untuk layanan ini, variabel lingkungan yang sesuai adalah`AWS_ENDPOINT_URL_ELASTIC_BEANSTALK`. Untuk daftar semua variabel lingkungan khusus layanan, lihat. [Pengidentifikasi untuk titik akhir khusus layanan](ss-endpoints-table.md)
```
export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK={{http://localhost:5567}}
```
## Konfigurasikan titik akhir menggunakan file bersama `config`
Dalam `config` file bersama, `endpoint_url` digunakan di tempat yang berbeda untuk fungsionalitas yang berbeda.
+ `endpoint_url`ditentukan secara langsung dalam a `profile` menjadikan titik akhir itu titik akhir global.
+ `endpoint_url`bersarang di bawah kunci pengenal layanan dalam `services` bagian membuat titik akhir tersebut berlaku untuk permintaan yang dibuat hanya untuk layanan tersebut. Untuk detail tentang mendefinisikan `services` bagian dalam `config` file bersama Anda, lihat[Format file konfigurasi](file-format.md#file-format-config).
Contoh berikut menggunakan `services` definisi untuk mengonfigurasi URL titik akhir khusus layanan yang akan digunakan untuk Amazon S3 dan titik akhir global khusus yang akan digunakan untuk semua layanan lainnya:
```
[profile {{dev-s3-specific-and-global}}]
endpoint_url = {{http://localhost:1234}}
services = {{s3-specific}}
[services {{s3-specific}}]
s3 =
endpoint_url = {{https://play.min.io:9000}}
```
Satu profil dapat mengonfigurasi titik akhir untuk beberapa layanan. Contoh ini menunjukkan cara menyetel titik akhir khusus layanan untuk Amazon URLs S3 dan AWS Elastic Beanstalk di profil yang sama. AWS Elastic Beanstalk memiliki `serviceId` dari [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9). Layanan AWS Pengenal didasarkan pada model API `serviceId` dengan mengganti semua spasi dengan garis bawah dan huruf kecil semua huruf. Dengan demikian, kunci pengidentifikasi layanan menjadi `elastic_beanstalk` dan pengaturan untuk layanan ini dimulai pada telepon`elastic_beanstalk = `. Untuk daftar semua kunci pengenal layanan yang akan digunakan di `services` bagian ini, lihat[Pengidentifikasi untuk titik akhir khusus layanan](ss-endpoints-table.md).
```
[services {{testing-s3-and-eb}}]
s3 =
endpoint_url = {{http://localhost:4567}}
elastic_beanstalk =
endpoint_url = {{http://localhost:8000}}
[profile {{dev}}]
services = {{testing-s3-and-eb}}
```
Bagian konfigurasi layanan dapat digunakan dari beberapa profil. Misalnya, dua profil dapat menggunakan `services` definisi yang sama sambil mengubah properti profil lainnya:
```
[services {{testing-s3}}]
s3 =
endpoint_url = {{https://localhost:4567}}
[profile {{testing-json}}]
output = json
services = {{testing-s3}}
[profile {{testing-text}}]
output = text
services = {{testing-s3}}
```
## Konfigurasikan titik akhir di profil menggunakan kredensi berbasis peran
Jika profil Anda memiliki kredensyal berbasis peran yang dikonfigurasi melalui `source_profile` parameter untuk fungsionalitas peran IAM, SDK hanya menggunakan konfigurasi layanan untuk profil yang ditentukan. Itu tidak menggunakan profil yang dirantai peran untuk itu. Misalnya, menggunakan `config` file bersama berikut:
```
[profile {{A}}]
credential_source = {{Ec2InstanceMetadata}}
endpoint_url = {{https://profile-a-endpoint.aws/}}
[profile {{B}}]
source_profile = {{A}}
role_arn = {{arn:aws:iam::123456789012:role/roleB}}
services = {{profileB}}
[services {{profileB}}]
ec2 =
endpoint_url = {{https://profile-b-ec2-endpoint.aws}}
```
Jika Anda menggunakan profil `B` dan membuat panggilan dalam kode Anda ke Amazon EC2, titik akhir akan diselesaikan sebagai. `https://profile-b-ec2-endpoint.aws` Jika kode Anda membuat permintaan ke layanan lain, resolusi titik akhir tidak akan mengikuti logika kustom apa pun. Titik akhir tidak menyelesaikan titik akhir global yang ditentukan dalam profil. `A` Agar titik akhir global berlaku untuk profil`B`, Anda perlu mengatur `endpoint_url` langsung di dalam profil`B`. Untuk informasi lebih lanjut tentang `source_profile` pengaturan, lihat[Asumsikan penyedia kredensi peran](feature-assume-role-credentials.md).
## Prioritas pengaturan
Pengaturan untuk fitur ini dapat digunakan pada saat yang sama tetapi hanya satu nilai yang akan diprioritaskan per layanan. Untuk panggilan API yang dibuat ke yang diberikan Layanan AWS, urutan berikut digunakan untuk memilih nilai:
1. Pengaturan eksplisit apa pun yang disetel dalam kode atau pada klien layanan itu sendiri lebih diutamakan daripada yang lain.
+ Untuk AWS CLI, ini adalah nilai yang disediakan oleh parameter baris `--endpoint-url` perintah. Untuk SDK, penetapan eksplisit dapat berupa parameter yang Anda tetapkan saat membuat instance objek Layanan AWS klien atau konfigurasi.
1. Nilai yang diberikan oleh variabel lingkungan khusus layanan seperti. `AWS_ENDPOINT_URL_DYNAMODB`
1. Nilai yang diberikan oleh variabel lingkungan endpoint `AWS_ENDPOINT_URL` global.
1. Nilai yang diberikan oleh `endpoint_url` pengaturan bersarang di bawah kunci pengenal layanan dalam `services` bagian file bersama`config`.
1. Nilai yang diberikan oleh `endpoint_url` pengaturan ditentukan langsung `profile` dalam `config` file bersama.
1. URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir.
## 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 untuk Java dan satu-satunya. AWS SDK untuk Kotlin
| SDK | Didukung | Catatan atau informasi lebih lanjut |
| --- | --- | --- |
| [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/) | Ya | |
| [SDK for C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Ya | |
| [SDK for Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Ya | |
| [SDK for Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Tidak | |
| [SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Ya | |
| [SDK for Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Tidak | |
| [SDK untuk 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Ya | |
| [SDK untuk 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Tidak | |
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Ya | |
| [SDK for .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Ya | |
| [SDK for .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Ya | |
| [SDK for PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Ya | |
| [SDK untuk Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Ya | |
| [SDK for Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Ya | |
| [SDK untuk Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Ya | |
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Ya | |
| [Alat untuk PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Ya | |
| [Alat untuk PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Ya | |