

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

# Menambahkan Penemuan Otomatis ke pustaka klien Memcached Anda
<a name="AutoDiscovery.AddingToYourClientLibrary"></a>

Informasi konfigurasi untuk Auto Discovery disimpan secara berlebihan di setiap node cluster Memcached. Aplikasi klien dapat mengueri simpul cache apa pun dan memperoleh informasi konfigurasi untuk semua simpul di klaster tersebut.

Cara sebuah aplikasi melakukannya akan tergantung pada versi mesin cache:
+ Jika versi mesin cache adalah **1.4.14 atau lebih tinggi**, gunakan perintah `config`.
+ Jika versi mesin cache **lebih rendah dari 1.4.14**, gunakan perintah `get AmazonElastiCache:cluster`.

Output dari kedua perintah ini identik, dan dijelaskan pada bagian [Format Output](#AutoDiscovery.AddingToYourClientLibrary.OutputFormat) di bawah ini.

## Cache engine versi 1.4.14 atau lebih tinggi
<a name="AutoDiscovery.AddingToYourClientLibrary.1-4-14-plus"></a>

Untuk versi mesin cache 1.4.14 atau lebih tinggi, gunakan perintah `config`. Perintah ini telah ditambahkan ke ASCII Memcached dan protokol biner oleh ElastiCache, dan diimplementasikan di Cluster Client. ElastiCache Jika Anda ingin menggunakan Penemuan Otomatis dengan pustaka klien lain, maka pustaka itu akan perlu diperluas untuk mendukung perintah `config`.

**catatan**  
Dokumentasi berikut berkaitan dengan protokol ASCII; namun, perintah `config` mendukung baik ASCII maupun biner. Jika Anda ingin menambahkan dukungan Auto Discovery menggunakan protokol biner, lihat [kode sumber untuk Klien ElastiCache Cluster](https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java/tree/master/src/main/java/net/spy/memcached/protocol/binary).

**Sintaksis**

`config [sub-command] [key]`

### Opsi
<a name="AutoDiscovery.AddingToYourClientLibrary.1-4-14-plus.Options"></a>


| Nama | Deskripsi | Wajib | 
| --- | --- | --- | 
| sub-command |  Sub-perintah yang digunakan untuk berinteraksi dengan simpul cache. Untuk Penemuan Otomatis, sub-perintah ini adalah `get`.  | Ya | 
| key |  Kunci yang digunakan untuk menyimpan konfigurasi klaster. Untuk Penemuan Otomatis, kunci ini disebut `cluster`.  | Ya | 

Untuk mendapatkan informasi konfigurasi klaster, gunakan perintah berikut: 

```
config get cluster
```

## Cache engine versi 1.4.14 atau lebih rendah
<a name="AutoDiscovery.AddingToYourClientLibrary.pre-1-4-14"></a>

Untuk mendapatkan informasi konfigurasi klaster, gunakan perintah berikut: 

```
get AmazonElastiCache:cluster
```

**catatan**  
Jangan mengutak-atik tombol “: clusterAmazonElastiCache”, karena di sinilah informasi konfigurasi cluster berada. Jika Anda menimpa kunci ini, maka klien mungkin salah dikonfigurasi untuk jangka waktu singkat (tidak lebih dari 15 detik) sebelum memperbarui informasi konfigurasi ElastiCache secara otomatis dan benar.

## Format Output
<a name="AutoDiscovery.AddingToYourClientLibrary.OutputFormat"></a>

Tergantung pada Anda menggunakan `config get cluster` atau `get AmazonElastiCache:cluster`, balasannya terdiri dari dua baris:
+ Nomor versi informasi konfigurasi. Setiap kali node ditambahkan atau dihapus dari cluster, nomor versi bertambah satu. 
+ Daftar simpul cache. Setiap simpul dalam daftar dinyatakan dengan grup *hostname\$1ip-address\$1port*, dan setiap simpul dibatasi dengan spasi. 

Karakter carriage return dan linefeed (CR\$1LF) muncul di akhir setiap baris. Baris data mengandung karakter linefeed (LF) di bagian akhir, tempat CR \$1 LF ditambahkan. Baris versi konfigurasi diakhiri dengan LF tanpa CR. 

Sebuah cluster yang berisi tiga node akan direpresentasikan sebagai berikut:

```
configversion\n
hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n
```

Setiap simpul ditampilkan dengan CNAME dan alamat IP privat. CNAME akan selalu ada; jika alamat IP privat tidak tersedia, maka tidak akan ditampilkan; namun, karakter pipa "`|`" akan tetap dicetak.

**Example**  
Berikut adalah contoh payload yang ditampilkan ketika Anda membuat kueri informasi konfigurasi:  

```
CONFIG cluster 0 136\r\n
12\n
myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n 
END\r\n
```

**catatan**  
Baris kedua menunjukkan bahwa informasi konfigurasi telah diubah dua belas kali sampai saat ini.
Pada baris ketiga, daftar simpul ditampilkan dalam urutan abjad berdasarkan nama host. Pengurutan ini mungkin berbeda dengan yang Anda gunakan saat ini pada aplikasi klien Anda.