Behebung von Fehlern für den AWS CLI

Beispiel-Fehlertext:

$ aws s3 copy
usage: aws [options] <command> <subcommand> [<subcommand> ...] [parameters]
To see help text, you can run:

  aws help
  aws <command> help
  aws <command> <subcommand> help
aws: error: argument subcommand: Invalid choice, valid choices are:

ls                                       | website                                 
cp                                       | mv                                      
....

Verschiedene Fehler können auftreten, wenn Ihr Befehl inkorrekt formatiert ist oder wenn Sie eine Version verwenden, die vor der Veröffentlichung der Funktion erstellt wurde. Weitere Informationen zur Behebung dieser beiden Arten von Problemen finden Sie unter Überprüfen Sie die Formatierung Ihrer AWS CLI Befehle und Sicherstellen, dass Sie eine aktuelle Version der AWS CLI ausführen.

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws --version
command not found: aws

Wenn der aws Befehl nach der ersten Installation oder Aktualisierung von nicht gefunden werden kann AWS CLI, müssen Sie möglicherweise Ihr Terminal neu starten, damit es alle PATH Updates erkennt.

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws --version
command not found: aws

Wenn der aws Befehl nach der ersten Installation oder Aktualisierung von nicht gefunden werden kann AWS CLI, wurde er möglicherweise nicht vollständig installiert. Versuchen Sie, sie erneut zu installieren, indem Sie die unter Installation oder Aktualisierung auf die neueste Version von AWS CLI angegebenen Schritte für Ihre Plattform ausführen.

Zurück zum Seitenanfang

Wenn der aws Befehl nach der ersten Installation oder Aktualisierung von AWS CLI unter Linux nicht gefunden werden kann, hat er möglicherweise keine execute Berechtigungen für den Ordner, in dem er installiert wurde. Führen Sie den folgenden Befehl zusammen mit Ihrer AWS CLI Installation aus, um chmod Berechtigungen für zu gewähren AWS CLI: PATH

$ sudo chmod -R 755 /usr/local/aws-cli/

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws --version
command not found: aws

Möglicherweise müssen Sie die ausführbare aws-Datei zur Umgebungsvariablen PATH des Betriebssystems hinzufügen. Verwenden Sie AWS CLI die folgenden Anweisungen für Ihr BetriebssystemPATH, um das zu Ihrem hinzuzufügen.

Wenn der aws-Befehl die falsche Version anzeigt, müssen Sie möglicherweise Ihr Terminal neu starten, damit PATH-Aktualisierungen erkannt werden. Alle offenen Terminals müssen geschlossen werden, nicht nur Ihr aktives Terminal.

Zurück zum Seitenanfang

Wenn der aws-Befehl die falsche Version anzeigt, müssen Sie möglicherweise Ihr Terminal neu starten, damit PATH-Aktualisierungen erkannt werden.

Zurück zum Seitenanfang

Wenn Sie das aktualisiert AWS CLI und eine andere Installationsmethode als Ihre bereits vorhandene Installation verwendet haben, können mehrere Versionen installiert werden. Beispiel: Wenn Sie unter Linux oder macOS pip für die aktuelle Installation verwendet, aber versucht haben, die Aktualisierung mithilfe der .pkg-Installationsdatei auszuführen, könnte dies zu Konflikten führen – insbesondere, wenn PATH auf die alte Version verweist.

Um dies zu beheben, deinstallieren Sie alle Versionen der AWS CLI und nehmen Sie eine Neuinstallation vor.

Befolgen Sie nach der Deinstallation aller Versionen die Anweisungen für Ihr Betriebssystem, um die gewünschte Version der AWS CLI Version 1 oder AWS CLI Version 2 zu installieren.

Zurück zum Seitenanfang

Wenn der Befehl aws --version weiterhin funktioniert, müssen Sie möglicherweise Ihr Terminal neu starten, damit Terminal-Aktualisierungen erkannt werden.

Zurück zum Seitenanfang

Sie werden AWS CLI möglicherweise nicht korrekt deinstalliert, wenn Sie sie AWS CLI mit einer anderen Methode deinstalliert haben, als Sie sie zur Installation verwendet haben, oder wenn Sie mehrere Versionen installiert haben. Wenn Sie beispielsweise pip für die aktuelle Installation verwendet haben, müssen Sie pip auch für die Deinstallation verwenden. Um dieses Problem zu beheben, deinstallieren Sie es AWS CLI mit derselben Methode, mit der Sie es installiert haben.

Zurück zum Seitenanfang

Da der AWS CLI mit Python erstellt wurde, AWS CLI verwendet der die argparse Python-Bibliothek, einschließlich des allow_abbrevArguments. Abkürzungen von Parametern werden von der erkannt AWS CLI und verarbeitet.

Das folgende Befehlsbeispiel ändert den CloudFormation Stacknamen. Der Parameter --change-set-n wird als Abkürzung für erkannt und der Befehl wird AWS CLI verarbeitet. --change-set-name

$ aws cloudformation create-change-set --stack-name my-stack --change-set-n my-change-set

Wenn sich Ihre Abkürzung auf mehrere Befehle beziehen könnte, wird der Parameter nicht als Abkürzung erkannt.

Das folgende Befehlsbeispiel ändert den CloudFormation Stacknamen. Der Parameter --change-set- wird nicht als Abkürzung erkannt, da es mehrere Parameter gibt, für die er eine Abkürzung sein könnte, z. B. --change-set-name und --change-set-type. Daher verarbeitet der den Befehl AWS CLI nicht.

$ aws cloudformation create-change-set --stack-name my-stack --change-set- my-change-set

$ aws ec2 describe-vpc-peering-connections \
    --filters Name=tag:TagName,Values=VpcPeeringConnection \
    --filter Name=status-code,Values=active 

Zurück zum Seitenanfang

Stellen Sie unter Linux oder macOS sicher, dass das aws-Programm über Ausführungsberechtigungen für den aufrufenden Benutzer verfügt. In der Regel sind die Berechtigungen auf 755 festgelegt.

Um Ihrem Benutzer die Ausführungsberechtigung hinzuzufügen, führen Sie den folgenden Befehl aus und ersetzen Sie ~/.local/bin/aws mit dem Pfad zum Programm auf Ihrem Computer.

$ chmod +x ~/.local/bin/aws

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws s3 ls
An error occurred (AcessDenied) when calling the ListBuckets operation: Access denied.

Wenn Sie einen AWS CLI Befehl ausführen, werden AWS Vorgänge in Ihrem Namen ausgeführt, wobei Anmeldeinformationen verwendet werden, die Sie einem IAM Konto oder einer Rolle zuordnen. Die beigefügten Richtlinien müssen Ihnen die Erlaubnis erteilen, die API Aktionen aufzurufen, die den Befehlen entsprechen, die Sie mit dem ausführen AWS CLI.

Die meisten Befehle rufen eine einzelne Aktion mit einem Namen auf, der dem Befehlsnamen entspricht. Benutzerdefinierte Befehle wie aws s3 sync Call Multiple sind jedoch möglichAPIs. Mithilfe der --debug Option können Sie sehen, welcher APIs Befehl aufgerufen wird.

Wenn Sie sicher sind, dass der Benutzer oder die Rolle über die richtigen, per Richtlinie zugewiesenen Berechtigungen verfügt, stellen Sie sicher, dass Ihr AWS CLI Befehl die Anmeldeinformationen verwendet, die Sie erwarten. Im nächsten Abschnitt über Anmeldeinformationen können Sie überprüfen, ob AWS CLI es sich bei den verwendeten Anmeldeinformationen um die von Ihnen erwarteten Anmeldeinformationen handelt.

Informationen zum Zuweisen von IAM Berechtigungen finden Sie im IAMBenutzerhandbuch unter Überblick über die Zugriffsverwaltung: Berechtigungen und Richtlinien.

Zurück zum Seitenanfang

AWS CLI Möglicherweise liest er Anmeldeinformationen von einem anderen Ort als erwartet, oder Ihre Schlüsselpaarinformationen sind falsch. Sie können aws configure list ausführen, um anzugeben, welche Anmeldeinformationen verwendet werden.

Das folgende Beispiel zeigt, wie Sie die Anmeldeinformationen prüfen, die für das Standardprofil verwendet werden.

$ aws configure list
      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                <not set>             None    None
access_key     ****************XYVA shared-credentials-file
secret_key     ****************ZAGY shared-credentials-file
    region                us-west-2      config-file    ~/.aws/config

Das folgende Beispiel zeigt, wie Sie die Anmeldeinformationen prüfen, die für das benannte Profil verwendet werden.

$ aws configure list --profile saanvi
      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                    saanvi           manual    --profile
access_key         **************** shared-credentials-file
secret_key         **************** shared-credentials-file
    region                us-west-2      config-file    ~/.aws/config

Bestätigen Sie die Schlüsselpaar-Informationen anhand Ihrer Dateien config und credentials. Weitere Informationen zu den Dateien config und credentials finden Sie unter Einstellungen für die Konfiguration und die Anmeldeinformationsdatei in der AWS CLI. Weitere Informationen zu Anmeldeinformationen und Authentifizierung finden Sie unter Authentifizierungs- und Zugangsdaten für AWS CLI.

Zurück zum Seitenanfang

Wenn Sie gültige Anmeldeinformationen verwenden, ist möglicherweise die Uhr nicht synchronisiert. Führen Sie unter Linux oder macOS date aus, um die Zeit zu überprüfen.

$ date

Wenn Ihre Systemuhr nicht innerhalb weniger Minuten korrigiert wird, synchronisieren Sie diese mit ntpd.

$ sudo service ntpd stop
$ sudo ntpdate time.nist.gov
$ sudo service ntpd start
$ ntpstat

Verwenden Sie unter Windows die Optionen für Datum und Uhrzeit in der Systemsteuerung, um Ihre Systemuhr zu konfigurieren.

Zurück zum Seitenanfang

Zum Schutz vor Replay-Angriffen kann die aktuelle Zeit während der Verschlüsselung/Entschlüsselung verwendet werden. Wenn die Zeit von Client und Server um mehr als den zulässigen Wert voneinander abweicht, schlägt der Prozess möglicherweise fehl und die Anfrage wird abgelehnt. Dies kann auch der Fall sein, wenn Sie einen Befehl in einer virtuellen Maschine ausführen, deren Uhr nicht mit der Uhr des Hostcomputers synchronisiert ist. Eine mögliche Ursache besteht darin, dass die virtuelle Maschine in den Ruhezustand versetzt wird und es nach dem erneuten Aktivieren einige Zeit dauert, die Uhr mit dem Hostcomputer zu synchronisieren.

Führen Sie unter Linux oder macOS date aus, um die Zeit zu überprüfen.

$ date

Wenn Ihre Systemuhr nicht innerhalb weniger Minuten korrigiert wird, synchronisieren Sie diese mit ntpd.

$ sudo service ntpd stop
$ sudo ntpdate time.nist.gov
$ sudo service ntpd start
$ ntpstat

Verwenden Sie unter Windows die Optionen für Datum und Uhrzeit in der Systemsteuerung, um Ihre Systemuhr zu konfigurieren.

Zurück zum Seitenanfang

Wenn Ihre AWS Schlüssel bestimmte Sonderzeichen wie,, oder enthalten - +/, verarbeiten einige Betriebssystemvarianten die Zeichenfolge nicht ordnungsgemäß und führen dazu%, dass die Schlüsselzeichenfolge falsch interpretiert wird.

Wenn Sie Ihre Schlüssel mit anderen Tools oder Skripten verarbeiten, z. B. mit Tools, die die Anmeldeinformationsdatei bei deren Erstellung auf einer neuen Instanz erstellen, können diese Tools und Skripten Sonderzeichen auf eigene Weise verarbeiten, sodass sie in etwas umgewandelt werden, das nicht AWS mehr erkannt wird.

Wir empfehlen, den geheimen Schlüssel neu zu generieren, um einen Schlüssel zu erhalten, der das Sonderzeichen nicht enthält.

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws s3 ls
[SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed

Wenn Sie einen AWS CLI Befehl verwenden, erhalten Sie eine [SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed Fehlermeldung. Dies liegt daran, dass Sie dem Zertifikat Ihres Proxys AWS CLI nicht vertrauen, z. B. weil das Zertifikat Ihres Proxys selbst signiert ist und Ihr Unternehmen als Zertifizierungsstelle (CA) festgelegt wurde. Dadurch wird verhindert, dass das AWS CLI CA-Stammzertifikat Ihres Unternehmens in der lokalen CA-Registrierung gefunden wird.

Um dieses Problem zu beheben, geben Sie anhand der Einstellung der .pem ca_bundle Konfigurationsdatei, der --ca-bundle Befehlszeilenoption oder der AWS_CA_BUNDLE Umgebungsvariablen an, AWS CLI wo Ihre Unternehmensdatei zu finden ist.

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws s3 ls
SSL validation failed for regionname [Errno 2] No such file or directory

Dies liegt daran, dass der Speicherort der Bundle-Datei Ihrer Zertifizierungsstelle (Certification Authority, CA) in der AWS CLI falsch konfiguriert ist. Überprüfen Sie zur Behebung dieses Fehlers, an welchem Speicherort sich die .pem-Datei Ihres Unternehmens befindet, und aktualisieren Sie die AWS CLI -Konfiguration mithilfe der Konfigurationsdateieinstellung ca_bundle, der Befehlszeilenoption --ca-bundle oder der Umgebungsvariablen AWS_CA_BUNDLE.

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws s3 ls
[SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed

Fehler oder unerwartete Ergebnisse können auftreten, wenn eine für die von Ihnen angegebene nicht AWS-Service verfügbar ist AWS-Region oder wenn sich Ihre Ressourcen in einer anderen befinden AWS-Region. Fehlerbehandlungsschritte finden Sie unter Überprüfen Sie, ob AWS-Region Ihr AWS CLI Befehl verwendet.

Zurück zum Seitenanfang

Beispiel-Fehlertext:

$ aws s3 ls
[SSL: UNSAFE_LEGACY_RENEGOTIATION_DISABLED] unsafe legacy renegotiation disabled

Die verwendet AWS-Service eine Version davonTLS, die nicht mit der TLS Version Ihres Geräts kompatibel ist. Um dieses Problem zu beheben, aktualisieren Sie auf eine unterstützte TLS Version. Weitere Informationen finden Sie unter Durchsetzung einer Mindestversion von TLS für AWS CLI.

Zurück zum Seitenanfang

Vergewissern Sie sich, dass Sie für Ihren Befehl eine gültige JSON Eingabe vorgenommen haben. Wir empfehlen die Verwendung eines JSON Validators, falls JSON Sie Probleme mit der Formatierung haben.

Für eine fortgeschrittenere JSON Verwendung in der Befehlszeile sollten Sie die Verwendung eines JSON Befehlszeilenprozessors in Betracht ziehenjq, z. B. um Zeichenketten zu erstellenJSON. Weitere Informationen dazu jq finden Sie im jq-Repository unter GitHub.

Zurück zum Seitenanfang

Bevor der etwas von einem Befehl AWS CLI empfängt, verarbeitet Ihr Terminal den Befehl mit seinen eigenen Regeln für Anführungszeichen und Escape-Zeichen. Aufgrund der Formatierungsregeln eines Terminals kann ein Teil Ihres JSON Inhalts entfernt werden, bevor der Befehl an den übergeben wird. AWS CLI Achten Sie beim Formulieren von Befehlen darauf, die Anführungszeichenregeln des Terminals zu berücksichtigen.

Verwenden Sie zur Fehlerbehebung den echo-Befehl, um zu sehen, wie die Shell mit Ihren Parametern umgeht:

$ echo {"ReadCapacityUnits":15,"WriteCapacityUnits":10}
ReadCapacityUnits:15 WriteCapacityUnits:10

$ echo '{"ReadCapacityUnits":15,"WriteCapacityUnits":10}'
{"ReadCapacityUnits":15,"WriteCapacityUnits":10}

Ändern Sie Ihren Befehl so lange, bis Ihr Befehl „Bis gültig“ zurückgegeben JSON wird.

Verwenden Sie für eine umfassendere Fehlerbehebung den --debug-Parameter, um die Debug-Protokolle anzuzeigen, da in diesen exakt zu sehen ist, was an die AWS CLIübergeben wurde:

$ aws dynamodb update-table \
    --provisioned-throughput '{"ReadCapacityUnits":15,WriteCapacityUnits":10}' \
    --table-name MyDDBTable \
    --debug
2022-07-19 22:25:07,741 - MainThread - awscli.clidriver - DEBUG - CLI version: aws-cli/1.18.147 
Python/2.7.18 Linux/5.4.196-119.356.amzn2int.x86_64 botocore/1.18.6
2022-07-19 22:25:07,741 - MainThread - awscli.clidriver - DEBUG - Arguments entered to CLI: 
['dynamodb', 'update-table', '--provisioned-throughput', '{"ReadCapacityUnits":15,WriteCapacityUnits":10}',
 '--table-name', 'MyDDBTable', '--debug']

Verwenden Sie die Angebotsregeln Ihres Terminals, um alle Probleme zu beheben, die Ihre JSON Eingabe beim Senden an die AWS CLI hat. Weitere Informationen zu Anführungszeichenregeln finden Sie unter Verwenden von Anführungszeichen und Literalen mit Zeichenketten in AWS CLI.

Zurück zum Seitenanfang