

**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.

# Mengkonfigurasi penyelesaian perintah di AWS CLI
<a name="cli-configure-completion"></a>

The AWS Command Line Interface (AWS CLI) menyertakan fitur penyelesaian perintah yang kompatibel dengan bash yang memungkinkan Anda menggunakan tombol **Tab** untuk menyelesaikan perintah yang dimasukkan sebagian. Pada sebagian besar sistem Anda perlu mengkonfigurasi ini secara manual.

**Topics**
+ [Cara kerjanya](#cli-command-completion-about)
+ [Mengkonfigurasi penyelesaian perintah di Linux atau macOS](#cli-command-completion-linux)
+ [Mengkonfigurasi penyelesaian perintah pada Windows](#cli-command-completion-windows)

## Cara kerjanya
<a name="cli-command-completion-about"></a>

Saat Anda memasukkan sebagian perintah, parameter, atau opsi, fitur penyelesaian perintah secara otomatis melengkapi perintah Anda atau menampilkan daftar perintah yang disarankan. Untuk meminta penyelesaian perintah, Anda memasukkan sebagian perintah dan menekan tombol penyelesaian, yang biasanya *Tab* di sebagian besar shell.

Contoh berikut menunjukkan berbagai cara yang dapat Anda gunakan penyelesaian perintah:
+ Masukkan sebagian perintah dan tekan *Tab* untuk menampilkan daftar perintah yang disarankan.

  ```
  $ aws dynamodb dTAB
  delete-backup                        describe-global-table
  delete-item                          describe-global-table-settings
  delete-table                         describe-limits
  describe-backup                      describe-table
  describe-continuous-backups          describe-table-replica-auto-scaling
  describe-contributor-insights        describe-time-to-live
  describe-endpoints
  ```
+ Masukkan sebagian parameter dan tekan *Tab* untuk menampilkan daftar parameter yang disarankan.

  ```
  $ aws dynamodb delete-table --TAB
  --ca-bundle              --endpoint-url           --profile              
  --cli-connect-timeout    --generate-cli-skeleton  --query                
  --cli-input-json         --no-paginate            --region               
  --cli-read-timeout       --no-sign-request        --table-name           
  --color                  --no-verify-ssl          --version              
  --debug                  --output
  ```
+ Masukkan parameter dan tekan *Tab* untuk menampilkan daftar nilai sumber daya yang disarankan. Fitur ini hanya tersedia di AWS CLI versi 2.

  ```
  $ aws dynamodb delete-table --table-name TAB
  Table 1                  Table 2                  Table 3
  ```

## Mengkonfigurasi penyelesaian perintah di Linux atau macOS
<a name="cli-command-completion-linux"></a>

Untuk mengonfigurasi penyelesaian perintah di Linux atau macOS, Anda harus mengetahui nama shell yang Anda gunakan dan lokasi skrip. `aws_completer`

**catatan**  
Penyelesaian perintah secara otomatis dikonfigurasi dan diaktifkan secara default pada instans Amazon EC2 yang menjalankan Amazon Linux.

**Topics**
+ [Konfirmasikan folder pelengkap ada di jalur Anda](#cli-command-completion-path)
+ [Aktifkan penyelesaian perintah](#cli-command-completion-enable)
+ [Verifikasi penyelesaian perintah](#cli-command-completion-test)

### Konfirmasikan folder pelengkap ada di jalur Anda
<a name="cli-command-completion-path"></a>

Agar AWS pelengkap berhasil bekerja, `aws_completer` kebutuhan harus berada di jalur shell Anda. `which`Perintah dapat memeriksa apakah pelengkap ada di jalur Anda.

```
$ which aws_completer
/usr/local/bin/aws_completer
```

Jika perintah yang tidak dapat menemukan pelengkap, maka gunakan langkah-langkah berikut untuk menambahkan folder pelengkap ke jalur Anda.

#### Langkah 1: Temukan AWS pelengkap
<a name="cli-command-completion-locate"></a>

 Lokasi AWS pelengkap dapat bervariasi tergantung pada metode instalasi yang digunakan. 
+ **Package Manager** - Program seperti `pip``yum`,`brew`,, dan `apt-get` biasanya menginstal AWS completer (atau symlink ke sana) ke lokasi jalur standar. 
  + Jika Anda menggunakan `pip` **tanpa** `--user` parameter, jalur defaultnya adalah`/usr/local/bin/aws_completer`.
  + **Jika Anda menggunakan `pip` `--user` parameter, jalur defaultnya adalah`/home/username/.local/bin/aws_completer`.**
+ **Penginstal yang Dibundel** - Jika Anda menggunakan penginstal yang dibundel, jalur defaultnya adalah. `/usr/local/bin/aws_completer`

Jika semuanya gagal, Anda dapat menggunakan `find` perintah untuk mencari sistem file Anda untuk AWS pelengkap. 

```
$ find / -name aws_completer
/usr/local/bin/aws_completer
```

#### Langkah 2: Identifikasi shell Anda
<a name="cli-command-completion-shell"></a>

Untuk mengidentifikasi shell yang Anda gunakan, Anda dapat menggunakan salah satu perintah berikut.
+ **echo \$1SHELL** - Menampilkan nama file program shell. Ini biasanya cocok dengan nama shell yang sedang digunakan, kecuali jika Anda meluncurkan shell yang berbeda setelah masuk.

  ```
  $ echo $SHELL
  /bin/bash
  ```
+ **ps** — Menampilkan proses yang berjalan untuk pengguna saat ini. Salah satunya adalah cangkangnya.

  ```
  $ ps
    PID TTY          TIME CMD
   2148 pts/1    00:00:00 bash
   8756 pts/1    00:00:00 ps
  ```

#### Langkah 3: Tambahkan pelengkap ke jalur Anda
<a name="cli-command-completion-path-add"></a>

1. Temukan penulisan profil shell Anda di folder pengguna Anda.

   ```
   $ ls -a ~/
   .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
   ```
   + **Bash** —`.bash_profile`,`.profile`, atau `.bash_login`
   + **Zsh** — `.zshrc`
   + **Tcsh**—`.tcshrc`,`.cshrc`, atau `.login`

1. Tambahkan perintah ekspor di akhir skrip profil Anda yang mirip dengan contoh berikut. Ganti `/usr/local/bin/` dengan folder yang Anda temukan di bagian sebelumnya.

   ```
   export PATH=/usr/local/bin/:$PATH
   ```

1. Muat ulang profil ke sesi saat ini untuk menerapkan perubahan tersebut. Ganti `.bash_profile` dengan nama skrip shell yang Anda temukan di bagian pertama.

   ```
   $ source ~/.bash_profile
   ```

### Aktifkan penyelesaian perintah
<a name="cli-command-completion-enable"></a>

Setelah mengonfirmasi bahwa pelengkap ada di jalur Anda, aktifkan penyelesaian perintah dengan menjalankan perintah yang sesuai untuk shell yang Anda gunakan. Anda dapat menambahkan perintah ke profil shell Anda untuk menjalankannya setiap kali Anda membuka shell baru. Di setiap perintah, ganti */usr/local/bin/* jalur dengan yang ditemukan di sistem Anda[Konfirmasikan folder pelengkap ada di jalur Anda](#cli-command-completion-path).
+ **`bash`**— Gunakan perintah bawaan`complete`.

  ```
  $ complete -C '/usr/local/bin/aws_completer' aws
  ```

  Tambahkan perintah sebelumnya `~/.bashrc` untuk menjalankannya setiap kali Anda membuka shell baru. Anda `~/.bash_profile` harus mencari sumber `~/.bashrc` untuk memastikan bahwa perintah juga dijalankan di shell login.
+  **`zsh`**— Untuk menjalankan penyelesaian perintah, Anda perlu menjalankan `bashcompinit` dengan menambahkan baris autoload berikut di akhir skrip `~/.zshrc` profil Anda.

  ```
  $ autoload bashcompinit && bashcompinit
  $ autoload -Uz compinit && compinit
  ```

  Untuk mengaktifkan penyelesaian perintah, gunakan perintah bawaan`complete`.

  ```
  $ complete -C '/usr/local/bin/aws_completer' aws
  ```

  Tambahkan perintah sebelumnya `~/.zshrc` untuk menjalankannya setiap kali Anda membuka shell baru.
+  **`tcsh`**— Lengkap untuk `tcsh` mengambil jenis kata dan pola untuk menentukan perilaku penyelesaian. 

  ```
  > complete aws 'p/*/`aws_completer`/'
  ```

  Tambahkan perintah sebelumnya `~/.tcshrc` untuk menjalankannya setiap kali Anda membuka shell baru.

Setelah Anda mengaktifkan penyelesaian perintah, [Verifikasi penyelesaian perintah](#cli-command-completion-test) berfungsi.

### Verifikasi penyelesaian perintah
<a name="cli-command-completion-test"></a>

Setelah mengaktifkan penyelesaian perintah, muat ulang shell Anda, masukkan perintah sebagian, dan tekan **Tab** untuk melihat perintah yang tersedia.

```
$ aws sTAB
s3              ses             sqs             sts             swf
s3api           sns             storagegateway  support
```

## Mengkonfigurasi penyelesaian perintah pada Windows
<a name="cli-command-completion-windows"></a>

**catatan**  
*Untuk informasi tentang cara PowerShell menangani penyelesaiannya, termasuk berbagai kunci penyelesaiannya, lihat [About\$1TAB\$1EXPANSION](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_tab_expansion) di Microsoft Docs. PowerShell*

Untuk mengaktifkan penyelesaian perintah PowerShell di Windows, selesaikan langkah-langkah berikut di PowerShell.

1. Buka Anda `$PROFILE` dengan perintah berikut.

   ```
   PS C:\> Notepad $PROFILE
   ```

   Jika Anda tidak memiliki`$PROFILE`, buat profil pengguna menggunakan perintah berikut.

   ```
   PS C:\> if (!(Test-Path -Path $PROFILE ))
   { New-Item -Type File -Path $PROFILE -Force }
   ```

   Untuk informasi selengkapnya tentang PowerShell profil, lihat [Cara Menggunakan Profil di Windows PowerShell ISE](https://docs.microsoft.com/en-us/powershell/scripting/windows-powershell/ise/how-to-use-profiles-in-windows-powershell-ise) di situs web *Microsoft Docs*.

1. Untuk mengaktifkan penyelesaian perintah, tambahkan blok kode berikut ke profil Anda, simpan, lalu tutup file.

   ```
   Register-ArgumentCompleter -Native -CommandName aws -ScriptBlock {
       param($commandName, $wordToComplete, $cursorPosition)
           $env:COMP_LINE=$wordToComplete
           if ($env:COMP_LINE.Length -lt $cursorPosition){
               $env:COMP_LINE=$env:COMP_LINE + " "
           }
           $env:COMP_POINT=$cursorPosition
           aws_completer.exe | ForEach-Object {
               [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
           }
           Remove-Item Env:\COMP_LINE     
           Remove-Item Env:\COMP_POINT  
   }
   ```

1. Setelah mengaktifkan penyelesaian perintah, muat ulang shell Anda, masukkan perintah sebagian, dan tekan **Tab** untuk menelusuri perintah yang tersedia.

   ```
   $ aws sTab
   ```

   ```
   $ aws s3
   ```

   **Untuk melihat semua perintah yang tersedia untuk penyelesaian Anda, masukkan perintah paral dan tekan **Ctrl\$1Space**.**

   ```
   $ aws sCtrl + Space
   s3              ses             sqs             sts             swf
   s3api           sns             storagegateway  support
   ```