Résolution des erreurs liées au AWS CLI

Exemple de texte d'erreur :

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

Diverses erreurs peuvent se produire si votre commande est mal formatée ou si vous utilisez une version antérieure à la publication de la fonctionnalité. Pour plus d'informations sur la résolution des erreurs liées à ces deux problèmes, consultez Vérifiez le formatage AWS CLI de vos commandes etVérifiez que vous utilisez une version récente du AWS CLI.

Retour en haut de page

Exemple de texte d'erreur :

$ aws --version
command not found: aws

Si la aws commande est introuvable après l'avoir installée ou mise à jour pour la première fois AWS CLI, vous devrez peut-être redémarrer votre terminal pour qu'il reconnaisse les PATH mises à jour.

Retour en haut de page

Exemple de texte d'erreur :

$ aws --version
command not found: aws

Si la aws commande est introuvable après l'installation ou la mise à jour initiale AWS CLI, il se peut qu'elle n'ait pas été complètement installée. Essayez de le réinstaller en suivant les étapes correspondant à votre plateforme dans Installation, mise à jour et désinstallation du AWS CLI.

Retour en haut de page

Si la aws commande est introuvable après l'avoir installée ou mise à jour pour la AWS CLI première fois sous Linux, il est possible qu'elle ne dispose pas des execute autorisations nécessaires pour le dossier dans lequel elle a été installée. Exécutez la commande suivante avec le PATH pour votre AWS CLI installation, afin de fournir chmod des autorisations à AWS CLI :

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

Retour en haut de page

Exemple de texte d'erreur :

$ aws --version
command not found: aws

Vous allez peut-être devoir ajouter le fichier exécutable aws à la variable d'environnement PATH de votre système d'exploitation. Pour ajouter le AWS CLI à votrePATH, suivez les instructions ci-dessous pour votre système d'exploitation.

Si la aws commande affiche une version incorrecte, vous devrez peut-être redémarrer votre terminal pour qu'il reconnaisse les PATH mises à jour. Tous les terminaux ouverts doivent être fermés, pas seulement votre terminal actif.

Retour en haut de page

Si la aws commande affiche la mauvaise version et que le redémarrage du terminal n'a pas fonctionné, vous devrez peut-être redémarrer votre système pour qu'il reconnaisse vos PATH mises à jour.

Retour en haut de page

Si vous avez mis à jour AWS CLI et utilisé une méthode d'installation différente de celle de votre installation préexistante, plusieurs versions peuvent être installées. Par exemple, si vous utilisez Linux ou macOS pip pour votre installation actuelle, mais que vous avez essayé de procéder à la mise à jour à l'aide du fichier d'.pkginstallation, cela peut provoquer des conflits, en particulier si vous PATH pointez vers l'ancienne version.

Pour résoudre ce problème, désinstallez toutes les versions de AWS CLI et effectuez une nouvelle installation.

Après avoir désinstallé toutes les versions, suivez les instructions adaptées à votre système d'exploitation pour installer la version souhaitée de la AWS CLI version 1 ou de la AWS CLI version 2.

Retour en haut de page

Si la aws --version commande fonctionne toujours, vous devrez peut-être redémarrer votre terminal pour qu'il reconnaisse les mises à jour du terminal.

Retour en haut de page

La désinstallation AWS CLI peut ne pas être correcte si vous l'avez désinstallée AWS CLI en utilisant une méthode différente de celle que vous avez utilisée pour l'installer, ou si vous avez installé plusieurs versions. Par exemple, si vous l'avez utilisé pip pour votre installation actuelle, vous devez l'utiliser pip pour le désinstaller. Pour résoudre ce problème, désinstallez-le AWS CLI en utilisant la même méthode que celle que vous avez utilisée pour l'installer.

Retour en haut de page

Étant donné que le AWS CLI est construit en utilisant Python, il AWS CLI utilise la argparse bibliothèque Python, y compris l'allow_abbrevargument. Les abréviations des paramètres sont reconnues par le AWS CLI et traitées.

L'exemple de create-change-setcommande suivant modifie le nom de la CloudFormation pile. Le paramètre --change-set-n est reconnu comme une abréviation de--change-set-name, et AWS CLI traite la commande.

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

Lorsque votre abréviation peut être composée de plusieurs commandes, le paramètre n'est pas reconnu comme une abréviation.

L'exemple de create-change-setcommande suivant modifie le nom de la CloudFormation pile. Le paramètre n'--change-set-est pas reconnu comme une abréviation, car il existe plusieurs paramètres dont il peut être une abréviation, tels que --change-set-name et--change-set-type. Par conséquent, la commande AWS CLI n'est pas traitée.

$ 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 

Retour en haut de page

Sous Linux ou macOS, assurez-vous que le aws programme dispose des autorisations d'exécution pour l'utilisateur appelant. En règle générale, les autorisations sont définies sur 755.

Pour ajouter une autorisation d'exécution à votre utilisateur, exécutez la commande suivante en la ~/.local/bin/aws remplaçant par le chemin d'accès au programme sur votre ordinateur.

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

Retour en haut de page

Exemple de texte d'erreur :

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

Lorsque vous exécutez une AWS CLI commande, les AWS opérations sont effectuées en votre nom, à l'aide des informations d'identification qui vous associent à un compte ou à un rôle IAM. Les politiques associées doivent vous autoriser à appeler les actions d'API correspondant aux commandes que vous exécutez avec le AWS CLI.

La plupart des commandes appellent une seule action avec un nom correspondant au nom de la commande. Cependant, des commandes personnalisées telles que aws s3 sync l'appel multiple APIs. Vous pouvez voir quelle APIs commande appelle en utilisant l'--debugoption.

Si vous êtes certain que l'utilisateur ou le rôle dispose des autorisations appropriées attribuées par la politique, assurez-vous que votre AWS CLI commande utilise les informations d'identification que vous attendez. Consultez la section suivante sur les informations d'identification pour vérifier que les AWS CLI informations d'identification utilisées sont celles que vous attendez.

Pour plus d'informations sur l'attribution d'autorisations IAM, voir Présentation de la gestion des accès : autorisations et politiques dans le guide de l'utilisateur IAM.

Retour en haut de page

AWS CLI Il est possible qu'ils lisent les informations d'identification à un endroit différent de celui prévu ou que les informations relatives à votre paire de clés soient incorrectes. Vous pouvez exécuter aws configure list pour confirmer quelles informations d'identification sont utilisées.

L'exemple suivant montre comment vérifier les informations d'identification utilisées pour le profil par défaut.

$ 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

L'exemple suivant montre comment vérifier les informations d'identification utilisées pour un profil nommé.

$ 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

Pour confirmer les détails de votre paire de clés, consultez vos credentials fichiers config et. Pour plus d'informations sur credentials les fichiers config et, consultezParamètres des fichiers de configuration et d'identification dans AWS CLI. Pour plus d'informations sur les informations d'identification et l'authentification, y compris la priorité des informations d'identification, consultezAuthentification et informations d'accès pour le AWS CLI.

Retour en haut de page

Si vous utilisez des informations d'identification valides, votre horloge est peut-être désynchronisée. Sur Linux ou macOS, exécutez date pour vérifier l'heure.

$ date

Si l'horloge de votre système n'est pas exacte en quelques minutes, utilisez ntpd pour la synchroniser.

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

Sous Windows, utilisez les options de date et d'heure du Panneau de configuration pour configurer votre horloge système.

Retour en haut de page

Pour vous aider à vous protéger contre les attaques par relecture, l'heure actuelle peut être utilisée pendant le processus de chiffrement/déchiffrement. Si la différence d'heure entre le client et le serveur est supérieure à la valeur autorisée, le processus peut échouer et la demande est rejetée. Cela peut également se produire lorsque vous exécutez une commande dans une machine virtuelle dont l'horloge est désynchronisée par rapport à l'horloge de la machine hôte. L'une des causes possibles est le fait que la machine virtuelle hiberne et qu'il faut un certain temps après le réveil pour synchroniser l'horloge avec la machine hôte.

Sur Linux ou macOS, exécutez date pour vérifier l'heure.

$ date

Si l'horloge de votre système n'est pas exacte en quelques minutes, utilisez ntpd pour la synchroniser.

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

Sous Windows, utilisez les options de date et d'heure du Panneau de configuration pour configurer votre horloge système.

Retour en haut de page

Si vos AWS touches contiennent certains caractères spéciaux, tels que,-, + /%, ou si certaines variantes du système d'exploitation traitent la chaîne de manière incorrecte, ce qui entraîne une interprétation incorrecte de la chaîne de touches.

Si vous traitez vos clés à l'aide d'autres outils ou scripts, tels que des outils qui créent le fichier d'informations d'identification sur une nouvelle instance dans le cadre de sa création, ces outils et scripts peuvent avoir leur propre gestion des caractères spéciaux, ce qui les transforme en quelque chose qui AWS ne les reconnaît plus.

Nous vous suggérons de régénérer la clé secrète pour en obtenir une qui n'inclut pas le caractère spécial à l'origine du problème.

Retour en haut de page

Exemple de texte d'erreur :

$ aws s3 ls
[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed

Lorsque vous utilisez une AWS CLI commande, vous recevez un message [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed d'erreur. Cela est dû au fait que vous AWS CLI ne faites pas confiance au certificat de votre proxy en raison de facteurs tels que le certificat de votre proxy étant auto-signé, votre entreprise étant définie comme autorité de certification (CA). Cela empêche AWS CLI de trouver le certificat racine de l'autorité de certification de votre entreprise dans le registre local de l'autorité de certification.

Pour résoudre ce problème, indiquez AWS CLI où trouver le fichier de votre entreprise à l'aide du paramètre du .pem fichier de ca_bundle configuration, de l'option de ligne de --ca-bundle commande ou de la variable d'AWS_CA_BUNDLEenvironnement.

Retour en haut de page

Exemple de texte d'erreur :

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

Cela est dû au fait que l'emplacement du fichier de votre bundle d'autorité de certification (CA) n'est pas correctement configuré dans le AWS CLI. Pour résoudre ce problème, vérifiez où se trouve .pem le fichier de votre entreprise et mettez à jour la AWS CLI configuration à l'aide du paramètre du fichier de ca_bundle configuration, de l'option de ligne de --ca-bundle commande ou de la variable d'AWS_CA_BUNDLEenvironnement.

Retour en haut de page

Exemple de texte d'erreur :

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

Des erreurs ou des résultats inattendus peuvent se produire si un Service AWS n'est pas disponible pour ce que vous avez spécifié Région AWS ou si vos ressources se trouvent dans un autre endroit Région AWS. Pour obtenir les étapes de dépannage, consultez Vérifiez que Région AWS votre AWS CLI commande utilise.

Retour en haut de page

Exemple de texte d'erreur :

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

Service AWS Il utilise une version de TLS incompatible avec la version TLS de votre appareil. Pour résoudre ce problème, effectuez une mise à jour vers une version TLS prise en charge. Pour de plus amples informations, veuillez consulter Appliquer une version minimale du protocole TLS pour AWS CLI.

Retour en haut de page

Vérifiez que vous avez saisi un code JSON valide pour votre commande. Nous vous suggérons d'utiliser un validateur JSON pour les fichiers JSON que vous rencontrez des problèmes de formatage.

Pour une utilisation plus avancée du JSON dans la ligne de commande, pensez à utiliser un processeur JSON en ligne de commandejq, par exemple pour créer des chaînes JSON. Pour plus d'informations surjq, consultez le référentiel jq sur GitHub.

Retour en haut de page

Avant de AWS CLI recevoir quoi que ce soit d'une commande, votre terminal traite la commande en utilisant ses propres règles de citation et d'échappement. En raison des règles de formatage d'un terminal, une partie de votre contenu JSON peut être supprimée avant que la commande ne soit transmise au AWS CLI. Lorsque vous formulez des commandes, veillez à utiliser les règles de citation de votre terminal.

Pour résoudre le problème, utilisez la echo commande pour voir comment le shell gère vos paramètres :

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

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

Modifiez votre commande jusqu'à ce que votre code JSON valide soit renvoyé.

Pour un dépannage plus approfondi, utilisez le --debug paramètre pour afficher les journaux de débogage, car ils afficheront exactement ce qui a été transmis au AWS CLI :

$ 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']

Utilisez les règles de citation de votre terminal pour résoudre les problèmes rencontrés par votre entrée JSON lorsqu'elle est envoyée au AWS CLI. Pour plus d'informations sur les règles de citation, voirUtiliser des guillemets et des littéraux avec des chaînes dans AWS CLI.

Retour en haut de page