Tetapkan titik akhir untuk satu perintah Tetapkan titik akhir global untuk semua Layanan AWS Setel untuk menggunakan FIPs titik akhir untuk semua Layanan AWS Setel untuk menggunakan titik akhir dual-stack untuk semua Layanan AWS Tetapkan titik akhir khusus layanan Konfigurasi titik akhir dan pengaturan diutamakan

Menggunakan titik akhir di AWS CLI

Untuk terhubung secara terprogram ke sebuah Layanan AWS, Anda menggunakan endpoint. Endpoint adalah URL titik masuk untuk layanan AWS web. The AWS Command Line Interface (AWS CLI) secara otomatis menggunakan titik akhir default untuk setiap layanan Wilayah AWS, tetapi Anda dapat menentukan titik akhir alternatif untuk permintaan API Anda.

Topik titik akhir

Tetapkan titik akhir untuk satu perintah

Untuk mengganti pengaturan titik akhir atau variabel lingkungan untuk satu perintah, gunakan opsi baris --endpoint-url perintah. Contoh perintah berikut menggunakan URL endpoint Amazon S3 kustom.


$ aws s3 ls --endpoint-url http://localhost:4567

Tetapkan titik akhir global untuk semua Layanan AWS

Untuk merutekan permintaan semua layanan ke URL titik akhir kustom, gunakan salah satu pengaturan berikut:

Variabel lingkungan:

AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Abaikan titik akhir URLs yang dikonfigurasi.

AWS_ENDPOINT_URL- Tetapkan URL titik akhir global.

configBerkas:
- ignore_configure_endpoint_urls- Abaikan titik akhir URLs yang dikonfigurasi.
```
ignore_configure_endpoint_urls = true
```
- endpoint_url- Tetapkan URL titik akhir global.
```
endpoint_url = http://localhost:4567
```

Titik akhir khusus layanan dan opsi baris --endpoint-url perintah mengganti titik akhir global apa pun.

Setel untuk menggunakan FIPs titik akhir untuk semua Layanan AWS

Untuk merutekan permintaan semua layanan agar menggunakan FIPs titik akhir, gunakan salah satu dari berikut ini:

AWS_USE_FIPS_ENDPOINTvariabel lingkungan.

use_fips_endpointpengaturan file.
```
use_fips_endpoint = true
```

Beberapa AWS layanan menawarkan titik akhir yang mendukung Federal Information Processing Standard (FIPS) 140-2 di beberapa. Wilayah AWS Ketika AWS layanan mendukung FIPS, pengaturan ini menentukan titik akhir FIPS apa yang harus digunakan. AWS CLI Tidak seperti AWS endpoint standar, endpoint FIPS menggunakan pustaka perangkat lunak TLS yang sesuai dengan FIPS 140-2. Titik akhir ini mungkin diperlukan oleh korporasi yang berinteraksi dengan pemerintah Amerika Serikat.

Jika pengaturan ini diaktifkan, tetapi titik akhir FIPS tidak ada untuk layanan di Anda Wilayah AWS, AWS perintah mungkin gagal. Dalam hal ini, tentukan secara manual titik akhir yang akan digunakan dalam perintah menggunakan --endpoint-url opsi atau gunakan titik akhir khusus layanan.

Untuk informasi selengkapnya tentang menentukan titik akhir FIPS menurut Wilayah AWS, lihat Titik Akhir FIPS menurut Layanan.

Setel untuk menggunakan titik akhir dual-stack untuk semua Layanan AWS

Untuk merutekan permintaan semua layanan agar menggunakan titik akhir dual-stack bila tersedia, gunakan salah satu pengaturan berikut:

AWS_USE_DUALSTACK_ENDPOINTvariabel lingkungan.

use_dualstack_endpointpengaturan file.
```
use_dualstack_endpoint = true
```

Mengaktifkan penggunaan titik akhir dual-stack untuk mengirim permintaan. AWS Untuk mempelajari lebih lanjut tentang titik akhir dual-stack, yang mendukung keduanya IPv4 dan IPv6 lalu lintas, lihat Menggunakan titik akhir tumpukan ganda Amazon S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon. Titik akhir dual-stack tersedia untuk beberapa layanan di beberapa wilayah. Jika titik akhir tumpukan ganda tidak ada untuk layanan atau Wilayah AWS, permintaan gagal. Ini dinonaktifkan secara default.

Tetapkan titik akhir khusus layanan

Konfigurasi titik akhir khusus layanan menyediakan opsi untuk menggunakan titik akhir persisten yang Anda pilih untuk permintaan. AWS CLI 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.

Titik akhir khusus layanan dapat ditentukan dengan cara berikut:

Opsi baris perintah --endpoint-url untuk satu perintah.
Variabel lingkungan:
- AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Abaikan semua titik akhir yang dikonfigurasi URLs, kecuali ditentukan pada baris perintah.
- AWS_ENDPOINT_URL_<SERVICE>- Menentukan endpoint kustom yang digunakan untuk layanan tertentu, di mana <SERVICE> mengganti dengan identifier. Layanan AWS Untuk semua variabel khusus layanan, lihat. Titik akhir khusus layanan: Daftar pengidentifikasi khusus layanan
configberkas:
- ignore_configure_endpoint_urls- Abaikan semua titik akhir yang dikonfigurasi URLs, kecuali ditentukan menggunakan variabel lingkungan atau pada baris perintah.
- servicesBagian config file dikombinasikan dengan pengaturan endpoint_url file.

Titik akhir khusus layanan: Variabel lingkungan

Variabel lingkungan mengganti pengaturan dalam file konfigurasi Anda, tetapi jangan mengganti opsi yang ditentukan pada baris perintah. Gunakan variabel lingkungan jika Anda ingin semua profil menggunakan titik akhir yang sama di perangkat Anda.

Berikut ini adalah variabel lingkungan khusus layanan:

AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Abaikan semua titik akhir yang dikonfigurasi URLs, kecuali ditentukan pada baris perintah.
Linux or macOS
```
$ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
```
Windows Command Prompt
Untuk mengatur semua sesi
```
C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true
```
Untuk mengatur untuk sesi saat ini saja
```
C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
```
PowerShell
```
PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"
```
AWS_ENDPOINT_URL_<SERVICE>- Menentukan endpoint kustom yang digunakan untuk layanan tertentu, di mana <SERVICE> diganti dengan identifier. Layanan AWS Untuk semua variabel khusus layanan, lihat. Titik akhir khusus layanan: Daftar pengidentifikasi khusus layanan

Contoh variabel lingkungan berikut menetapkan titik akhir untuk AWS Elastic Beanstalk:
Linux or macOS
```
$ export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
```
Windows Command Prompt
Untuk mengatur semua sesi
```
C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567
```
Untuk mengatur untuk sesi saat ini saja
```
C:\> set AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
```
PowerShell
```
PS C:\> $Env:AWS_ENDPOINT_URL_ELASTIC_BEANSTALK="http://localhost:4567"
```

Untuk informasi selengkapnya tentang pengaturan variabel lingkungan, lihatMengkonfigurasi variabel lingkungan untuk AWS CLI.

Titik akhir khusus layanan: File bersama `config`

Dalam config file bersama, endpoint_url digunakan dalam beberapa bagian. Untuk menyetel titik akhir khusus layanan, gunakan endpoint_url setelan yang bersarang di bawah kunci pengenal layanan di dalam bagian. services Untuk detail tentang mendefinisikan services bagian dalam config file bersama Anda, lihatJenis bagian: services.

Contoh berikut menggunakan services bagian untuk mengonfigurasi URL titik akhir khusus layanan untuk Amazon S3 dan titik akhir global khusus yang digunakan untuk semua layanan lainnya:


[profile dev1]
endpoint_url = http://localhost:1234
services = s3-specific

[services testing-s3]
s3 = 
  endpoint_url = http://localhost:4567

Satu profil dapat mengonfigurasi titik akhir untuk beberapa layanan. Contoh berikut menetapkan titik akhir khusus layanan untuk Amazon URLs S3 dan AWS Elastic Beanstalk di profil yang sama.

Untuk daftar semua kunci pengenal layanan yang akan digunakan di services bagian ini, lihatDaftar pengidentifikasi khusus layanan.


[profile dev1]
services = testing-s3-and-eb

[services testing-s3-and-eb]
s3 = 
  endpoint_url = http://localhost:4567
elastic_beanstalk = 
  endpoint_url = http://localhost:8000

Bagian konfigurasi layanan dapat digunakan di beberapa profil. Contoh berikut memiliki dua profil menggunakan services definisi yang sama:


[profile dev1]
output = json
services = testing-s3

[profile dev2]
output = text
services = testing-s3

[services testing-s3]
s3 = 
  endpoint_url = https://localhost:4567

Titik akhir khusus layanan: Daftar pengidentifikasi khusus layanan

Layanan AWS Pengenal didasarkan pada model API serviceId dengan mengganti semua spasi dengan garis bawah dan huruf kecil semua huruf.

Contoh pengenal layanan berikut menggunakan AWS Elastic Beanstalk. AWS Elastic Beanstalk memiliki serviceId dariElastic Beanstalk, oleh karena itu kunci pengenal layanan adalahelastic_beanstalk.

Tabel berikut mencantumkan semua pengidentifikasi khusus layanan, kunci config file, dan variabel lingkungan.

Konfigurasi titik akhir dan pengaturan diutamakan

Pengaturan konfigurasi titik akhir terletak di beberapa tempat, seperti variabel sistem atau lingkungan pengguna, file AWS konfigurasi lokal, atau dinyatakan secara eksplisit pada baris perintah sebagai parameter. Pengaturan konfigurasi AWS CLI titik akhir diutamakan dalam urutan sebagai berikut:

Opsi baris --endpoint-url perintah.
Jika diaktifkan, variabel lingkungan endpoint AWS_IGNORE_CONFIGURED_ENDPOINT_URLS global atau pengaturan profil ignore_configure_endpoint_urls untuk mengabaikan endpoint kustom.
Nilai yang diberikan oleh variabel lingkungan khusus layananAWS_ENDPOINT_URL_<SERVICE>, seperti. AWS_ENDPOINT_URL_DYNAMODB
Nilai yang disediakan olehAWS_USE_DUALSTACK_ENDPOINT,AWS_USE_FIPS_ENDPOINT, dan variabel AWS_ENDPOINT_URL lingkungan.
Nilai endpoint khusus layanan yang disediakan oleh endpoint_url pengaturan dalam services bagian file bersama. config
Nilai yang diberikan oleh endpoint_url pengaturan profile dalam config file bersama.
use_dualstack_endpoint,use_fips_endpoint, dan endpoint_url pengaturan.
URL endpoint default untuk masing-masing Layanan AWS digunakan terakhir. Untuk daftar titik akhir layanan standar yang tersedia di setiap Wilayah, lihat AWS Wilayah dan Titik Akhir di. Referensi Umum Amazon Web Services

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menggunakan proxy HTTP untuk AWS CLI

Otentikasi dan akses kredensional