Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Referensi
Topik di bagian ini mencakup bekerja dengan Amazon ElastiCache API dan ElastiCache bagian dari AWS CLI. Juga disertakan pada bagian ini adalah pesan kesalahan dan notifikasi layanan yang umum.
+ [Menggunakan ElastiCache API](ProgrammingGuide.md)
+ [ElastiCache Referensi API](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/Welcome.html)
+ [ElastiCache bagian dari AWS CLI Referensi](https://docs.aws.amazon.com/cli/latest/reference/elasticache/index.html)
+ [Pesan ElastiCache kesalahan Amazon](ErrorMessages.md)
+ [Notifikasi](elasticache-notifications.md)
## Menyiapkan antarmuka baris ElastiCache perintah
Bagian ini menjelaskan prasyarat untuk menjalankan alat baris perintah, tempat mendapatkannya, cara mengatur lingkungannya, dan contoh umum penggunaan alat ini.
Ikuti instruksi dalam topik ini hanya jika Anda mau ElastiCache. AWS CLI
**penting**
Amazon ElastiCache Command Line Interface (CLI) tidak mendukung ElastiCache perbaikan apa pun setelah versi API 2014-09-30. Untuk menggunakan ElastiCache fungsionalitas yang lebih baru dari baris perintah, gunakan [antarmuka baris AWS perintah](https://aws.amazon.com/cli).
**Topics**
+ [Prasyarat](#prerequisites)
+ [Mendapatkan alat baris perintah](#Overview.SetupTools.Getting)
+ [Menyiapkan alat](#Overview.SetupTools.WhereTheyAre)
+ [Memberikan kredensial untuk alat](#Overview.SetupTools.WhoYouAre)
+ [Variabel lingkungan](#Overview.SetupTools.EnvironmentalVariables)
### Prasyarat
Dokumen ini mengasumsikan bahwa Anda dapat bekerja di lingkungan Linux/UNIX atau Windows. Alat baris ElastiCache perintah Amazon juga berfungsi pada Mac OS X, yang merupakan lingkungan berbasis Unix; Namun, tidak ada instruksi Mac OS X tertentu yang disertakan dalam panduan ini.
Sebagai konvensi, semua teks baris perintah diawali dengan prompt baris perintah **`PROMPT> `** generik. Prompt baris perintah yang sebenarnya pada mesin Anda mungkin berbeda. Kami juga menggunakan **`$ `** untuk menunjukkan perintah Linux/UNIX tertentu dan **`C:\> `** untuk perintah khusus Windows. Contoh output yang dihasilkan dari perintah ditampilkan tepat setelahnya tanpa awalan apa pun.
#### Lingkungan runtime Java
Alat baris perintah yang digunakan dalam panduan ini memerlukan Java versi 5 atau yang lebih baru. Dapat menggunakan penginstalan JRE atau JDK. Untuk melihat dan mengunduh JREs berbagai platform, termasuk Linux/UNIX dan Windows, lihat [Unduhan Java SE](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
##### Mengatur variabel Java Home
Alat baris perintah bergantung pada variabel lingkungan (`JAVA_HOME`) untuk menemukan Java Runtime. Variabel lingkungan ini harus ditetapkan ke jalur lengkap dari direktori yang berisi subdirektori bernama `bin` yang berisi executable `java` (di Linux dan UNIX) atau executable `java.exe` (di Windows).
**Untuk mengatur variabel Java Home**
1. Atur variabel Java Home.
+ Di Linux dan UNIX, masukkan perintah berikut:
```
$ export JAVA_HOME=
```
+ Di Windows, masukkan perintah berikut:
```
C:\> set JAVA_HOME=
```
1. Konfirmasikan pengaturan jalur dengan menjalankan **\$1JAVA\$1HOME/bin/java -version** dan memeriksa output-nya.
+ Di Linux/UNIX, Anda akan melihat output seperti yang berikut ini:
```
$ $JAVA_HOME/bin/java -version
java version "1.6.0_23"
Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)
```
+ Di Windows, Anda akan melihat output seperti yang berikut ini:
```
C:\> %JAVA_HOME%\bin\java -version
java version "1.6.0_23"
Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)
```
### Mendapatkan alat baris perintah
Alat baris perintah tersedia sebagai file ZIP pada [ElastiCache situs web Alat Developer](https://aws.amazon.com/developertools/Amazon-ElastiCache). Alat-alat ini ditulis dalam Java, dan termasuk skrip shell untuk Windows 2000/XP/Vista/Windows 7, Linux/UNIX, dan Mac OSX. File ZIP bersifat mandiri dan tidak memerlukan penginstalan; cukup unduh file zip lalu ekstrak ke direktori di mesin lokal Anda.
### Menyiapkan alat
Alat baris perintah bergantung pada variabel lingkungan (AWS\$1ELASTICACHE\$1HOME) untuk menemukan pustaka pendukung. Anda perlu mengatur variabel lingkungan ini sebelum dapat menggunakan alat tersebut. Tetapkan ke jalur direktori tempat Anda mengekstrak file alat baris perintah. Direktori ini bernama ElastiCacheCli -A.B.NNNN (A, B dan n adalah versi/nomor rilis), dan berisi subdirektori bernama bin dan lib.
**Untuk mengatur variabel lingkungan AWS\$1ELASTICACHE\$1HOME**
+ Buka jendela baris perintah dan masukkan salah satu perintah berikut untuk mengatur variabel lingkungan AWS\$1ELASTICACHE\$1HOME.
+ Di Linux dan UNIX, masukkan perintah berikut:
```
$ export &AWS;_ELASTICACHE_HOME=
```
+ Di Windows, masukkan perintah berikut:
```
C:\> set &AWS;_ELASTICACHE_HOME=
```
Agar alat ini lebih mudah digunakan, sebaiknya tambahkan direktori BIN alat ini ke PATH sistem Anda. Sisa dari panduan ini akan mengasumsikan bahwa direktori BIN sudah ada dalam jalur sistem Anda.
**Untuk menambahkan direktori BIN alat ini ke jalur sistem Anda**
+ Masukkan perintah berikut untuk menambahkan direktori BIN alat ini ke PATH sistem Anda.
+ Di Linux dan UNIX, masukkan perintah berikut:
```
$ export PATH=$PATH:$&AWS;_ELASTICACHE_HOME/bin
```
+ Di Windows, masukkan perintah berikut:
```
C:\> set PATH=%PATH%;%&AWS;_ELASTICACHE_HOME%\bin
```
**catatan**
Variabel lingkungan Windows direset ketika Anda menutup jendela perintah. Anda sebaiknya menetapkannya secara permanen. Lihat dokumentasi untuk versi Windows Anda untuk informasi selengkapnya.
**catatan**
Jalur yang berisi spasi harus di-wrapping dengan tanda kutip ganda, misalnya:
"C:\$1Program Files\$1Java"
### Memberikan kredensial untuk alat
Alat baris perintah memerlukan Kunci AWS Akses dan Kunci Akses Rahasia yang disediakan dengan AWS akun Anda. Anda bisa mendapatkannya menggunakan baris perintah atau dari file kredensial yang terletak di sistem lokal Anda.
Penerapan menyertakan file template \$1 \$1AWS\$1ELASTICACHE\$1HOME\$1/credential-file-path.template yang perlu Anda edit dengan informasi Anda. Berikut adalah konten file templat:
```
AWS AccessKeyId=
AWS SecretKey=
```
**penting**
Di UNIX, batasi izin untuk pemilik file kredensial:
```
$ chmod 600
```
Dengan pengaturan file kredensial, Anda harus mengatur variabel lingkungan AWS\$1CREDENTIAL\$1FILE sehingga alat dapat menemukan informasi Anda. ElastiCache
**Untuk mengatur variabel lingkungan AWS\$1CREDENTIAL\$1FILE**
1. Atur variabel lingkungan:
+ Di Linux dan UNIX, perbarui variabel menggunakan perintah berikut:
```
$ export &AWS;_CREDENTIAL_FILE=
```
+ Di Windows, tetapkan variabel menggunakan perintah berikut:
```
C:\> set &AWS;_CREDENTIAL_FILE=
```
1. Periksa bahwa pengaturan Anda bekerja dengan baik, jalankan perintah berikut:
```
elasticache --help
```
Anda harus melihat halaman penggunaan untuk semua perintah ElastiCache.
### Variabel lingkungan
Variabel lingkungan dapat berguna untuk membuat skrip, mengonfigurasi nilai default, atau mengganti variabel untuk sementara.
Selain variabel lingkungan AWS\$1CREDENTIAL\$1FILE, sebagian besar alat API yang disertakan dengan Antarmuka Baris ElastiCache Perintah mendukung variabel berikut:
+ **EC2\$1REGION** - AWS Wilayah yang akan digunakan.
+ **AWS\$1ELASTICACHE\$1URL** – URL yang digunakan untuk panggilan layanan. Tidak diperlukan untuk menentukan titik akhir regional yang berbeda jika EC2 \$1REGION ditentukan atau parameter --region dilewatkan.
Contoh berikut menunjukkan cara menyetel variabel lingkungan EC2 \$1REGION untuk mengonfigurasi wilayah yang digunakan oleh alat API:
Linux, OS X, atau Unix
```
1. $ export EC2_REGION=us-west-1
```
Windows
```
1. $ set EC2_REGION=us-west-1
```