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, Aktualisierung und Deinstallation des 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 create-change-setBefehlsbeispiel ä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 create-change-setBefehlsbeispiel ä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 ihn durch ~/.local/bin/aws den 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 die AWS Vorgänge in Ihrem Namen ausgeführt, wobei Anmeldeinformationen verwendet werden, die Sie einem IAM-Konto oder einer IAM-Rolle zuordnen. Die angefügten Richtlinien müssen Ihnen die Berechtigung zum Aufrufen der API-Aktionen erteilen, die den Befehlen entsprechen, die Sie mit der AWS CLI ausführen.

Die meisten Befehle rufen eine einzelne Aktion mit einem Namen auf, der dem Befehlsnamen entspricht. Benutzerdefinierte Befehle wie aws s3 sync call multiple APIs jedoch. 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. Sehen Sie sich den nächsten Abschnitt über Anmeldeinformationen an, um zu überprüfen, ob AWS CLI es sich bei den verwendeten Anmeldeinformationen um die von Ihnen erwarteten Anmeldeinformationen handelt.

Weitere Informationen zum Zuweisen von IAM-Berechtigungen finden Sie unter Übersicht über die Zugriffsverwaltung: Berechtigungen und Richtlinien im IAM-Benutzerhandbuch.

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 die 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 während des encryption/decryption Vorgangs die aktuelle Uhrzeit 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 AWS CLI das CA-Stammzertifikat Ihres Unternehmens in der lokalen CA-Registrierung findet.

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

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 von TLS, 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 die AWS CLI.

Zurück zum Seitenanfang

Vergewissern Sie sich, dass Sie ein gültiges JSON für Ihren Befehl eingegeben haben. Wir empfehlen die Verwendung eines JSON-Validators, wenn Sie Probleme bei der JSON-Formatierung haben.

Für eine erweiterte JSON-Nutzung in einer Befehlszeile sollten Sie einen Befehlszeilen-JSON-Prozessor wie jq verwenden, um JSON-Strings zu erstellen. Weitere Informationen dazu jq finden Sie im jq-Repository unter GitHub.

Zurück zum Seitenanfang

Bevor das 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 des Terminals wird ein Teil Ihres JSON-Inhalts möglicherweise entfernt, bevor der Befehl an die AWS CLIübergeben wird. 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, bis ein gültiges JSON zurückgegeben 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 Anführungszeichenregeln Ihres Terminals, um alle Probleme in Ihrer JSON-Eingabe beim Senden an die AWS CLI zu beheben. Weitere Informationen zu Anführungszeichenregeln finden Sie unter Verwenden von Anführungszeichen und Literalen mit Zeichenketten in AWS CLI.

Zurück zum Seitenanfang