

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Hinzufügen von Auto Discovery zu Ihrer Memcached-Clientbibliothek
<a name="AutoDiscovery.AddingToYourClientLibrary"></a>

Die Konfigurationsinformationen für Auto Discovery werden redundant in jedem Memcached-Clusterknoten gespeichert. Client-Anwendungen können jeden Cache-Knoten abfragen und die Konfigurationsinformationen für alle Knoten im Cluster abrufen.

Die jeweilige Methode, die eine Anwendung dazu nutzt, hängt von der Cache-Engine-Version ab:
+ Wenn die Cache-Engine-Version **1.4.14 oder höher** ist, verwenden Sie den Befehl `config`.
+ Wenn die Cache-Engine-Version **älter als 1.4.14** ist, verwenden Sie den Befehl `get AmazonElastiCache:cluster`.

Die Ausgaben dieser beiden Befehle sind identisch und werden im Abschnitt [Ausgabeformat](#AutoDiscovery.AddingToYourClientLibrary.OutputFormat) beschrieben.

## Cache-Engine-Version 1.4.14 oder höher
<a name="AutoDiscovery.AddingToYourClientLibrary.1-4-14-plus"></a>

Für die Cache-Engine-Version 1.4.14 oder höher verwenden Sie den Befehl `config`. Dieser Befehl wurde den Memcached ASCII- und Binärprotokollen von hinzugefügt und ist im Cluster ElastiCache Client implementiert. ElastiCache Wenn Sie Auto Discovery mit einer anderen Client-Bibliothek verwenden möchten, muss diese Bibliothek um den Support für den Befehl `config` erweitert werden.

**Anmerkung**  
Die folgende Dokumentation bezieht sich zwar auf das ASCII-Protokoll, der Befehl `config` unterstützt jedoch sowohl das ASCII- als auch das Binärprotokoll. Wenn Sie Auto Discovery-Unterstützung mithilfe des Binärprotokolls hinzufügen möchten, lesen Sie im [Quellcode für den Cluster-Client](https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java/tree/master/src/main/java/net/spy/memcached/protocol/binary) nach. ElastiCache 

**Syntax**

`config [sub-command] [key]`

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


| Name | Description | Erforderlich | 
| --- | --- | --- | 
| sub-command |  Der Unterbefehl, der zum Interagieren mit einem Cache-Knoten verwendet wird. Für Auto Discovery lautet dieser Unterbefehl `get`.  | Ja | 
| key |  Der Schlüssel, mit dem die Cluster-Konfiguration gespeichert ist. Für Auto Discovery lautet dieser Schlüssel `cluster`.  | Ja | 

Verwenden Sie zum Abrufen der Cluster-Konfigurationsinformationen den folgenden Befehl: 

```
config get cluster
```

## Cache-Engine-Version 1.4.14 oder niedriger
<a name="AutoDiscovery.AddingToYourClientLibrary.pre-1-4-14"></a>

Verwenden Sie zum Abrufen der Cluster-Konfigurationsinformationen den folgenden Befehl: 

```
get AmazonElastiCache:cluster
```

**Anmerkung**  
Verändern Sie nicht den Schlüssel „:clusterAmazonElastiCache“, da sich dort die Cluster-Konfigurationsinformationen befinden. Wenn Sie diesen Schlüssel überschreiben, ist der Client möglicherweise für einen kurzen Zeitraum (nicht länger als 15 Sekunden) falsch konfiguriert, bevor die Konfigurationsinformationen ElastiCache automatisch und korrekt aktualisiert werden.

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

Wenn Sie `config get cluster` oder `get AmazonElastiCache:cluster` verwenden, umfasst die Antwort zwei Zeilen:
+ Die Versionsnummer der Konfigurationsinformationen. Jedes Mal, wenn ein Knoten dem Cluster hinzugefügt oder daraus entfernt wird, erhöht sich die Versionsnummer um eins. 
+ Eine Liste der Cache-Knoten. Jeder Knoten in der Liste wird durch eine *hostname\$1ip-address\$1port*-Gruppe repräsentiert und durch ein Leerzeichen getrennt. 

Am Ende jeder Zeile erscheint ein Wagenrücklauf- und Zeilenvorschubzeichen (CR \$1 LF). Die Datenzeile enthält am Ende ein Zeilenvorschubzeichen (LF), dem die Zeichen CR \$1 LF hinzugefügt werden. Die Config-Versionszeile wird durch LF ohne CR beendet. 

Ein Cluster mit drei Knoten würde wie folgt dargestellt:

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

Jeder Knoten wird sowohl mit dem CNAME als auch der privaten IP-Adresse angezeigt. Der CNAME ist immer vorhanden. Wenn die private IP-Adresse nicht verfügbar ist, wird sie nicht angezeigt. Die Pipe-Zeichen "`|`" werden dennoch gedruckt.

**Example**  
Das nachfolgende Beispiel zeigt die Nutzlast, die zurückgegeben wird, wenn Sie die Konfigurationsinformationen abfragen:  

```
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
```

**Anmerkung**  
Die zweite Zeile gibt an, dass die Konfigurationsinformationen bisher zwölfmal geändert wurden.
In der dritten Zeile wird die Liste der Knoten in alphabetischer Reihenfolge nach Hostname angegeben. Diese Reihenfolge kann sich von der Sequenz unterscheiden, die Sie derzeit in Ihrer Client-Anwendung verwenden.