View a markdown version of this page

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-based 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 Anzeigen und Herunterladen von 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.

    • Wenn diese Option aktiviert ist Linux/UNIX, werden Sie eine Ausgabe sehen, die der folgenden ähnelt:

      
$ $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-Skripte für Windows 2000/XP Vista/Windows /7 und Mac OSX. Linux/UNIX 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 einen Namen ElastiCacheCli-A.B.nnnn (A, B und n sind version/release Zahlen) und enthält Unterverzeichnisse mit den Namen bin und lib.

Um die Umgebungsvariable AWS_ELASTICACHE_HOME festzulegen

  • Ö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 enthält eine Vorlagendatei ${AWS_ELASTICACHE_HOME}/credential-file-path.template, die Sie an Ihre Informationen anpassen 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 ElastiCache Tools Ihre Informationen finden können.

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 ist oder der Parameter --region übergeben wird.

Die folgenden Beispiele zeigen, wie Sie die Umgebungsvariable EC2_REGION setzen, 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