**Dokumentasi ini AWS CLI hanya untuk Versi 1.**

Kami mengumumkan yang akan datang end-of-support untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat [pengumuman](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat [Panduan Pengguna Versi 2](https://docs.aws.amazon.com/cli/latest/userguide/).

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

# Menggunakan titik akhir di AWS CLI
<a name="cli-configure-endpoints"></a>

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.

**Contents**
+ [

## Tetapkan titik akhir untuk satu perintah
](#endpoints-command)
+ [

## Tetapkan titik akhir global untuk semua Layanan AWS
](#endpoints-global)
+ [

## Setel untuk menggunakan FIPs titik akhir untuk semua Layanan AWS
](#endpoints-fips)
+ [

## Setel untuk menggunakan titik akhir dual-stack untuk semua Layanan AWS
](#endpoints-dual-stack)
+ [

## Tetapkan titik akhir khusus layanan
](#endpoints-service-specific)
  + [Variabel-variabel lingkungan](#endpoints-service-specific-envvars)
  + [`config`Berkas bersama](#endpoints-service-specific-config)
  + [Daftar pengidentifikasi khusus layanan](#endpoints-service-specific-table)
+ [Titik akhir berbasis akun](#endpoints-accountid)
+ [

## Konfigurasi titik akhir dan pengaturan diutamakan
](#endpoints-precedence)

## Tetapkan titik akhir untuk satu perintah
<a name="endpoints-command"></a>

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
<a name="endpoints-global"></a>

Untuk merutekan permintaan semua layanan ke URL titik akhir kustom, gunakan salah satu pengaturan berikut:
+ Variabel lingkungan:
  + `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Abaikan titik akhir URLs yang dikonfigurasi.

------
#### [ 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\$1ENDPOINT\$1URL`- Tetapkan URL titik akhir global.

------
#### [ Linux or macOS ]

    ```
    $ export AWS_ENDPOINT_URL=http://localhost:4567
    ```

------
#### [ Windows Command Prompt ]

    **Untuk mengatur semua sesi**

    ```
    C:\> setx AWS_ENDPOINT_URL http://localhost:4567
    ```

    **Untuk mengatur untuk sesi saat ini saja**

    ```
    C:\> set AWS_ENDPOINT_URL=http://localhost:4567
    ```

------
#### [ PowerShell ]

    ```
    PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567"
    ```

------
+ `config`Berkas:
  + `ignore\$1configure\$1endpoint\$1urls`- Abaikan titik akhir URLs yang dikonfigurasi.

    ```
    ignore_configure_endpoint_urls = true
    ```
  + `endpoint\$1url`- 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
<a name="endpoints-fips"></a>

Untuk merutekan permintaan semua layanan agar menggunakan FIPs titik akhir, gunakan salah satu dari berikut ini:
+ `AWS\$1USE\$1FIPS\$1ENDPOINT`variabel lingkungan.

------
#### [ Linux or macOS ]

  ```
  $ export AWS_USE_FIPS_ENDPOINT=true
  ```

------
#### [ Windows Command Prompt ]

  **Untuk mengatur semua sesi**

  ```
  C:\> setx AWS_USE_FIPS_ENDPOINT true
  ```

  **Untuk mengatur untuk sesi saat ini saja**

  ```
  C:\> set AWS_USE_FIPS_ENDPOINT=true
  ```

------
#### [ PowerShell ]

  ```
  PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true"
  ```

------
+ `use\$1fips\$1endpoint`pengaturan file.

  ```
  use_fips_endpoint = true
  ```

Beberapa AWS layanan menawarkan titik akhir yang mendukung [Federal Information Processing Standard (FIPS) 140-2](https://aws.amazon.com/compliance/fips/) 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](#endpoints-service-specific).

Untuk informasi selengkapnya tentang menentukan titik akhir FIPS menurut Wilayah AWS, lihat Titik Akhir [FIPS](https://aws.amazon.com/compliance/fips/) menurut Layanan.

## Setel untuk menggunakan titik akhir dual-stack untuk semua Layanan AWS
<a name="endpoints-dual-stack"></a>

Untuk merutekan permintaan semua layanan agar menggunakan titik akhir dual-stack bila tersedia, gunakan salah satu pengaturan berikut:
+ `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`variabel lingkungan.

------
#### [ Linux or macOS ]

  ```
  $ export AWS_USE_DUALSTACK_ENDPOINT=true
  ```

------
#### [ Windows Command Prompt ]

  **Untuk mengatur semua sesi**

  ```
  C:\> setx AWS_USE_DUALSTACK_ENDPOINT true
  ```

  **Untuk mengatur untuk sesi saat ini saja**

  ```
  C:\> set AWS_USE_DUALSTACK_ENDPOINT=true
  ```

------
#### [ PowerShell ]

  ```
  PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true"
  ```

------
+ `use\$1dualstack\$1endpoint`pengaturan 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html) 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
<a name="endpoints-service-specific"></a>

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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- Abaikan semua titik akhir yang dikonfigurasi URLs, kecuali ditentukan pada baris perintah.
  + `AWS\$1ENDPOINT\$1URL\$1<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](#endpoints-service-specific-table)
+ `config`berkas:
  + `ignore\$1configure\$1endpoint\$1urls`- Abaikan semua titik akhir yang dikonfigurasi URLs, kecuali ditentukan menggunakan variabel lingkungan atau pada baris perintah.
  + [`services`](cli-configure-files.md#cli-configure-files-format-services)Bagian `config` file dikombinasikan dengan pengaturan `endpoint\$1url` file.

**Topics**
+ [Variabel-variabel lingkungan](#endpoints-service-specific-envvars)
+ [`config`Berkas bersama](#endpoints-service-specific-config)
+ [Daftar pengidentifikasi khusus layanan](#endpoints-service-specific-table)

### Titik akhir khusus layanan: Variabel lingkungan
<a name="endpoints-service-specific-envvars"></a>

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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`- 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\$1ENDPOINT\$1URL\$1<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](#endpoints-service-specific-table)

  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, lihat[Mengkonfigurasi variabel lingkungan untuk AWS CLI](cli-configure-envvars.md).

### Titik akhir khusus layanan: File bersama `config`
<a name="endpoints-service-specific-config"></a>

Dalam `config` file bersama, `endpoint_url` digunakan dalam beberapa bagian. Untuk menyetel titik akhir khusus layanan, gunakan `endpoint_url` pengaturan yang bersarang di bawah kunci pengenal layanan di dalam bagian. `services` Untuk detail tentang mendefinisikan `services` bagian dalam `config` file bersama Anda, lihat[Jenis bagian: `services`](cli-configure-files.md#cli-configure-files-format-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, lihat[Daftar pengidentifikasi khusus layanan](#endpoints-service-specific-table). 

```
[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
<a name="endpoints-service-specific-table"></a>

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

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

## Titik akhir berbasis akun
<a name="endpoints-accountid"></a>

Titik akhir berbasis akun dapat ditentukan dengan cara berikut:
+ Variabel-variabel lingkungan
  + `AWS\$1ACCOUNT\$1ID`- Menentukan ID endpoint AWS berbasis akun untuk digunakan untuk panggilan ke didukung. Layanan AWS

------
#### [ Linux or macOS ]

    ```
    $ export AWS_ACCOUNT_ID=<account-id>
    ```

------
#### [ Windows Command Prompt ]

    **Untuk mengatur semua sesi**

    ```
    C:\> setx AWS_ACCOUNT_ID <account-id>
    ```

    **Untuk mengatur untuk sesi saat ini saja**

    ```
    C:\> set AWS_ACCOUNT_ID=<account-id>
    ```

------
#### [ PowerShell ]

    ```
    PS C:\> $Env:AWS_ACCOUNT_ID="<account-id>"
    ```

------
  + `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE`- Menentukan apakah akan menggunakan endpoint AWS berbasis akun IDs untuk panggilan ke didukung. Layanan AWS Dapat diatur ke`preferred`,`disabled`, atau`required`. Nilai default-nya adalah `preferred`.

------
#### [ Linux or macOS ]

    ```
    $ export AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred
    ```

------
#### [ Windows Command Prompt ]

    **Untuk mengatur semua sesi**

    ```
    C:\> setx AWS_ACCOUNT_ID_ENDPOINT_MODE preferred
    ```

    **Untuk mengatur untuk sesi saat ini saja**

    ```
    C:\> set AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred
    ```

------
#### [ PowerShell ]

    ```
    PS C:\> $Env:AWS_ACCOUNT_ID_ENDPOINT_MODE="preferred"
    ```

------
+ `config`Berkas:
  + `aws\$1account\$1id`- Menentukan ID endpoint AWS berbasis akun untuk digunakan untuk panggilan ke didukung. Layanan AWS

    ```
    aws_account_id = <account-id>
    ```
  + `account\$1id\$1endpoint\$1mode`- Menentukan apakah akan menggunakan endpoint AWS berbasis akun IDs untuk panggilan ke didukung. Layanan AWS Dapat diatur ke`preferred`,`disabled`, atau`required`. Nilai default lebih disukai.

    ```
    account_id_endpoint_mode = preferred
    ```

Titik akhir berbasis akun membantu memastikan kinerja dan skalabilitas tinggi dengan menggunakan ID AWS akun Anda untuk merampingkan perutean Layanan AWS permintaan layanan yang mendukung fitur ini. Bila Anda menggunakan penyedia kredensyal dan layanan yang mendukung endpoint berbasis akun, AWS CLI secara otomatis membangun dan menggunakan endpoint berbasis akun, bukan endpoint regional.

Endpoint berbasis akun menggunakan format berikut, di `<account-id>` mana diganti dengan ID AWS akun Anda dan `<region>` diganti dengan: Wilayah AWS

```
https://<account-id>.myservice.<region>.amazonaws.com
```

Secara default di AWS CLI, mode endpoint berbasis akun diatur ke. `preferred`

## Konfigurasi titik akhir dan pengaturan diutamakan
<a name="endpoints-precedence"></a>

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:

1. Opsi baris `--endpoint-url` perintah.

1. Jika diaktifkan, variabel lingkungan endpoint `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS` global atau pengaturan profil `ignore\$1configure\$1endpoint\$1urls` untuk mengabaikan endpoint kustom.

1. Nilai yang diberikan oleh variabel lingkungan khusus layanan`AWS\$1ENDPOINT\$1URL\$1<SERVICE>`, seperti. `AWS_ENDPOINT_URL_DYNAMODB`

1. Nilai yang disediakan oleh`AWS\$1USE\$1DUALSTACK\$1ENDPOINT`,`AWS\$1USE\$1FIPS\$1ENDPOINT`, dan variabel `AWS\$1ENDPOINT\$1URL` lingkungan.

1. Variabel `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE` lingkungan diatur ke `preferred` atau `required` menggunakan ID Akun dalam variabel `AWS\$1ACCOUNT\$1ID` lingkungan atau `aws\$1account\$1id` pengaturan.

1. Nilai endpoint khusus layanan yang disediakan oleh `endpoint\$1url` pengaturan dalam `services` bagian file bersama. `config`

1. Nilai yang diberikan oleh `endpoint\$1url` pengaturan `profile` dalam `config` file bersama.

1. `use\$1dualstack\$1endpoint`,`use\$1fips\$1endpoint`, dan `endpoint\$1url` pengaturan.

1. `account\$1id\$1endpoint\$1mode`Pengaturan diatur ke `preferred` atau `required` menggunakan ID Akun dalam variabel `AWS\$1ACCOUNT\$1ID` lingkungan atau `aws\$1account\$1id` pengaturan.

1. 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](https://docs.aws.amazon.com/general/latest/gr/rande.html) di. *Referensi Umum Amazon Web Services*