Referenz - Amazon ElastiCache
Richten Sie das AWS CLI für ein ElastiCache

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.

Referenz

Die Themen in diesem Abschnitt behandeln die Arbeit mit der ElastiCache Amazon-API und den ElastiCache Abschnitt der AWS CLI. In diesem Abschnitt sind auch allgemeine Fehlermeldungen und Servicemeldungen enthalten.

Einrichtung der ElastiCache Befehlszeilenschnittstelle

In diesem Abschnitt wird beschrieben, welche Voraussetzungen für die Ausführung der Befehlszeilen-Tools erforderlich sind, wo Sie die Befehlszeilen-Tools herunterladen können und wie die Tools und die Umgebung eingerichtet werden. Zudem werden gängige Beispiele für die Nutzung der Tools vorgestellt.

Folgen Sie den Anweisungen in diesem Thema nur, wenn Sie AWS CLI zum Forum wechseln ElastiCache.

Wichtig

Die Amazon ElastiCache Command Line Interface (CLI) unterstützt keine ElastiCache Verbesserungen nach API-Version 2014-09-30. Um neuere ElastiCache Funktionen von der Befehlszeile aus zu verwenden, verwenden Sie die AWS Befehlszeilenschnittstelle.

Voraussetzungen

In diesem Dokument wird davon ausgegangen, dass Sie in einer Linux/UNIX oder einer Windows-Umgebung arbeiten können. Die ElastiCache Amazon-Befehlszeilentools funktionieren auch unter Mac OS X, einer UNIX-basierten Umgebung. In diesem Handbuch sind jedoch keine spezifischen Mac OS X-Anweisungen enthalten.

Als Konvention wird jeglichem Befehlszeilentext die generische Eingabeaufforderung PROMPT> vorangestellt. Der auf dem Rechner tatsächlich angezeigte Prompt sieht wahrscheinlich anders aus. Wir verwenden $ sie auch, um einen Linux/UNIX bestimmten Befehl und C:\> für einen Windows-spezifischen Befehl anzugeben. Die Beispielausgabe des Befehls wird direkt im Anschluss ohne Präfix angezeigt.

Die Java-Laufzeitumgebung

Für die in diesem Handbuch verwendeten Befehlszeilen-Tools muss Java Version 5 oder höher ausgeführt werden. Eine JRE- oder JDK-Installation ist zulässig. Informationen zum Ansehen und Herunterladen JREs für eine Reihe von Plattformen, einschließlich Linux/UNIX Windows, finden Sie unter Java SE-Downloads.

Einrichten der Java-Home-Variablen

Die Befehlszeilen-Tools sind von einer Umgebungsvariablen (JAVA_HOME) abhängig, um die Java-Runtime zu finden. Diese Umgebungsvariable sollte auf den vollständigen Pfad des Verzeichnisses gesetzt werden, das ein Unterverzeichnis namens bin enthält, das wiederum die ausführbare java-Datei (unter Linux und UNIX) oder die ausführbare java.exe-Datei (unter Windows) enthält.

Einrichten der Java Home-Variablen

  1. Einrichten der Java Home-Variablen.

    • Geben Sie unter Linux und UNIX den folgenden Befehl ein:

      $ export JAVA_HOME=<PATH>

    • Geben Sie unter Windows den folgenden Befehl ein:

      C:\> set JAVA_HOME=<PATH>

  2. Bestätigen Sie die Pfadeinrichtung, indem Sie $JAVA_HOME/bin/java -version ausführen und die Ausgabe überprüfen.

    • Die Ausgabe unter Linux/UNIX entspricht weitgehend der Folgenden:

      
$ $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)

    • Unter Windows sehen Sie eine Ausgabe vergleichbar der Folgenden:

      
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)

Aufrufen der Befehlszeilen-Tools

Die Befehlszeilen-Tools stehen als ZIP-Datei auf der Website ElastiCache -Entwickler-Tools zur Verfügung. Diese Tools sind in Java geschrieben und enthalten Shell-Skripts für Windows 2000/ XP/Vista/Windows 7, Linux/UNIX und Mac OSX. Die ZIP-Datei ist unabhängig und erfordert keine Installation; laden Sie einfach die ZIP-Datei herunter und entpacken Sie sie in ein Verzeichnis auf Ihrem lokalen Rechner.

Einrichten der Tools

Die Befehlszeilen-Tools sind von einer Umgebungsvariablen (AWS_ELASTICACHE_HOME) abhängig, um unterstützende Bibliotheken zu finden. Sie müssen diese Umgebungsvariable festlegen, bevor Sie die Tools verwenden können. Setzen Sie sie auf den Pfad des Verzeichnisses, in das Sie die Befehlszeilen-Tools entpackt haben. Dieses Verzeichnis hat den Namen ElastiCacheCli -A.b.nnnn (A, B und n sind Versions-/Versionsnummern) und enthält Unterverzeichnisse mit den Namen bin und lib.

So AWS legen Sie die Umgebungsvariable _ELASTICACHE_HOME fest

  • Öffnen Sie ein Befehlszeilenfenster und geben Sie einen der folgenden Befehle ein, um die Umgebungsvariable _ELASTICACHE_HOME festzulegen. AWS

    • Geben Sie unter Linux und UNIX den folgenden Befehl ein:

      $ export &AWS;_ELASTICACHE_HOME=<path-to-tools>

    • Geben Sie unter Windows den folgenden Befehl ein:

      C:\> set &AWS;_ELASTICACHE_HOME=<path-to-tools>

Um die Verwendung der Tools zu vereinfachen, empfehlen wir Ihnen, das BIN-Verzeichnis der Tools Ihrem System-Pfad hinzuzufügen. Der Rest dieser Anleitung geht davon aus, dass sich das BIN-Verzeichnis in Ihrem Systempfad befindet.

Das BIN-Verzeichnis der Tools Ihrem Systempfad hinzufügen

  • Geben Sie die folgenden Befehle ein, um das BIN-Verzeichnis der Tools zu Ihrem System-PATH hinzuzufügen.

    • Geben Sie unter Linux und UNIX den folgenden Befehl ein:

      $ export PATH=$PATH:$&AWS;_ELASTICACHE_HOME/bin

    • Geben Sie unter Windows den folgenden Befehl ein:

      C:\> set PATH=%PATH%;%&AWS;_ELASTICACHE_HOME%\bin
Anmerkung

Die Windows-Umgebungsvariablen werden zurückgesetzt, wenn Sie das Befehlsfenster schließen. Möglicherweise wollen Sie sie permanent einrichten. Weitere Informationen finden Sie in der Dokumentation zu Ihrer Windows-Version.

Anmerkung

Pfade, die ein Leerzeichen enthalten, müssen in Anführungszeichen gesetzt werden, z. B.:

"C:\Program Files\Java"

Bereitstellung von Anmeldeinformationen für die Tools

Die Befehlszeilentools benötigen den AWS Access Key und den Secret Access Key, die Sie mit Ihrem Konto erhalten haben. AWS Sie können sie über die Befehlszeile oder aus einer Anmeldeinformationsdatei auf Ihrem lokalen System beziehen.

Die Bereitstellung umfasst eine Vorlagendatei $ {AWS_ELASTICACHE_HOME}/credential-file-path.template, die Sie mit Ihren Informationen bearbeiten müssen. Nachfolgend finden Sie dem Inhalt der Template-Datei:


AWS AccessKeyId=<Write your AWS access ID>
AWS SecretKey=<Write your AWS secret key>
Wichtig

Unter UNIX sollten Sie die Berechtigungen auf den Eigentümer der Anmeldeinformationsdatei beschränken:

$ chmod 600 <the file created above>

Bei der Einrichtung der Anmeldeinformationsdatei müssen Sie die Umgebungsvariable AWS_CREDENTIAL_FILE festlegen, damit die Tools Ihre Informationen finden können. ElastiCache

Um die Umgebungsvariable _CREDENTIAL_FILE festzulegen AWS

  1. Legen Sie die -Umgebungsvariable fest:

    • Aktualisieren Sie unter Linux und UNIX die Variable mit folgendem Befehl:

      $ export &AWS;_CREDENTIAL_FILE=<the file created above>

    • Legen Sie unter Windows die Variable mit folgendem Befehl fest:

      C:\> set &AWS;_CREDENTIAL_FILE=<the file created above>

  2. Überprüfen Sie, ob Ihre Einrichtung ordnungsgemäß funktioniert, und führen Sie den folgenden Befehl aus:

    elasticache --help

    Sie sollten die Verwendungsseite für alle ElastiCache-Befehle sehen.

Umgebungsvariablen

Umgebungsvariablen können nützlich sein, um Skripts zu erstellen, Standardwerte zu konfigurieren oder sie vorübergehend zu überschreiben.

Zusätzlich zur Umgebungsvariablen AWS_CREDENTIAL_FILE unterstützen die meisten API-Tools, die in der Befehlszeilenschnittstelle enthalten sind, die ElastiCache folgenden Variablen:

  • EC2_REGION — Die zu verwendende Region. AWS

  • AWS_ELASTICACHE_URL – Die für den Serviceaufruf zu verwendende URL. Es ist nicht erforderlich, einen anderen regionalen Endpunkt anzugeben, wenn EC2 _REGION angegeben oder der Parameter --region übergeben wird.

Die folgenden Beispiele zeigen, wie die Umgebungsvariable EC2 _REGION gesetzt wird, um die von den API-Tools verwendete Region zu konfigurieren:

Linux, OS X oder Unix


$ export EC2_REGION=us-west-1

Windows


$ set EC2_REGION=us-west-1