Risoluzione degli errori per AWS CLI

Esempio di testo di errore:

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

Possono verificarsi diversi errori se il comando è formattato in modo errato o se si utilizza una versione precedente precedente al rilascio della funzionalità. Per ulteriori informazioni sulla risoluzione degli errori relativi a questi due problemi, consulta e. Controlla la formattazione AWS CLI dei comandi Conferma che stai utilizzando una versione recente di AWS CLI

Torna all'inizio

Testo di errore di esempio:

$ aws --version
command not found: aws

Se il aws comando non viene trovato dopo la prima installazione o l'aggiornamento di AWS CLI, potrebbe essere necessario riavviare il terminale per far sì che riconosca eventuali PATH aggiornamenti.

Torna all'inizio

Testo di errore di esempio:

$ aws --version
command not found: aws

Se il aws comando non può essere trovato dopo la prima installazione o l'aggiornamento di AWS CLI, è possibile che non sia stato installato completamente. Prova a reinstallarlo seguendo i passaggi relativi alla tua piattaforma in Installazione, aggiornamento e disinstallazione di AWS CLI.

Torna all'inizio

Se il aws comando non viene trovato dopo la prima installazione o l'aggiornamento AWS CLI su Linux, è possibile che non disponga execute delle autorizzazioni per la cartella in cui è installato. Esegui il seguente comando con la PATH tua AWS CLI installazione, per fornire chmod le autorizzazioni a: AWS CLI

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

Torna all'inizio

Testo di errore di esempio:

$ aws --version
command not found: aws

Potrebbe essere necessario aggiungere l'eseguibile aws alla variabile di ambiente PATH del sistema operativo in uso. Per aggiungerlo AWS CLI al tuoPATH, usa le seguenti istruzioni per il tuo sistema operativo.

Se il aws comando mostra la versione sbagliata, potrebbe essere necessario riavviare il terminale per riconoscere eventuali PATH aggiornamenti. Tutti i terminali aperti devono essere chiusi, non solo il terminale attivo.

Torna all'inizio

Se il aws comando mostra la versione sbagliata e il riavvio del terminale non ha funzionato, potrebbe essere necessario riavviare il sistema per far sì che riconosca gli aggiornamenti. PATH

Torna all'inizio

Se hai aggiornato AWS CLI e utilizzato un metodo di installazione diverso da quello dell'installazione preesistente, è possibile che vengano installate più versioni. Ad esempio, se su Linux o macOS lo hai utilizzato pip per l'installazione corrente, ma hai provato ad aggiornare utilizzando il file di .pkg installazione, ciò potrebbe causare alcuni conflitti, specialmente con il PATH riferimento alla versione precedente.

Per risolvere il problema, disinstalla tutte le versioni di AWS CLI ed esegui un'installazione pulita.

Dopo aver disinstallato tutte le versioni, segui le istruzioni appropriate per il tuo sistema operativo per installare la versione desiderata della AWS CLI versione 1 o della AWS CLI versione 2.

Torna all'inizio

Se il aws --version comando funziona ancora, potrebbe essere necessario riavviare il terminale per far sì che riconosca eventuali aggiornamenti del terminale.

Torna all'inizio

AWS CLI Potrebbe non essere disinstallato correttamente se lo hai disinstallato AWS CLI utilizzando un metodo diverso da quello usato per installarlo o se hai installato più versioni. Ad esempio, se l'hai utilizzata pip per l'installazione corrente, devi pip disinstallarla. Per risolvere il problema, esegui la disinstallazione AWS CLI utilizzando lo stesso metodo utilizzato per installarla.

Torna all'inizio

Poiché AWS CLI è stato creato utilizzando Python, AWS CLI utilizza la argparse libreria Python, incluso l'argomento. allow_abbrev Le abbreviazioni dei parametri vengono riconosciute da ed elaborate AWS CLI .

Il seguente esempio di create-change-setcomando modifica il nome dello CloudFormation stack. Il parametro --change-set-n viene riconosciuto come abbreviazione di --change-set-name ed AWS CLI elabora il comando.

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

Se l'abbreviazione potrebbe essere composta da più comandi, il parametro non verrà riconosciuto come abbreviazione.

Il seguente esempio di create-change-setcomando modifica il nome dello CloudFormation stack. Il parametro non --change-set- è riconosciuto come abbreviazione, poiché esistono più parametri di cui potrebbe essere un'abbreviazione, ad esempio and. --change-set-name --change-set-type Pertanto AWS CLI non elabora il comando.

$ 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 

Torna all'inizio

Su Linux o macOS, assicurati che il aws programma disponga delle autorizzazioni di esecuzione per l'utente chiamante. In genere, le autorizzazioni sono impostate su 755.

Per aggiungere l'autorizzazione di esecuzione per il tuo utente, esegui il comando seguente, sostituendo ~/.local/bin/aws con il percorso del programma sul tuo computer.

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

Torna all'inizio

Esempio di testo di errore:

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

Quando esegui un AWS CLI comando, AWS le operazioni vengono eseguite per tuo conto, utilizzando credenziali che ti associano a un IAM account o a un ruolo. I criteri allegati devono concedere all'utente l'autorizzazione a richiamare API le azioni che corrispondono ai comandi eseguiti con. AWS CLI

La maggior parte dei comandi chiamano una singola operazione con un nome corrispondente al nome del comando. Tuttavia, comandi personalizzati come le aws s3 sync chiamate multipleAPIs. È possibile vedere quale APIs comando chiama utilizzando l'--debugopzione.

Se sei sicuro che l'utente o il ruolo disponga delle autorizzazioni appropriate assegnate dalla policy, assicurati che il AWS CLI comando utilizzi le credenziali previste. Consultate la sezione successiva sulle credenziali per verificare che le credenziali utilizzate AWS CLI siano quelle previste.

Per informazioni sull'assegnazione IAM delle autorizzazioni, vedere Panoramica sulla gestione degli accessi: autorizzazioni e politiche nella Guida per l'utente. IAM

Torna all'inizio

È AWS CLI possibile che stia leggendo le credenziali da una posizione diversa da quella prevista o che le informazioni sulla coppia di chiavi non siano corrette. Puoi eseguire aws configure list per verificare le credenziali utilizzate.

L'esempio seguente mostra come controllare le credenziali utilizzate per il profilo predefinito.

$ 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'esempio seguente mostra come controllare le credenziali di un profilo denominato.

$ 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

Per confermare i dettagli della tua key pair, controlla i tuoi credentials file config e. Per ulteriori informazioni sui credentials file config and, consultaImpostazioni dei file di configurazione e credenziali in AWS CLI. Per ulteriori informazioni sulle credenziali e sull'autenticazione, inclusa la precedenza delle credenziali, vedere. Credenziali di autenticazione e accesso per AWS CLI

Torna all'inizio

Se utilizzi credenziali valide, l'orologio potrebbe non essere sincronizzato. Su Linux o macOS, esegui date per controllare l'ora.

$ date

Se l'orologio di sistema non viene corretto nel giro di pochi minuti, utilizza ntpd per sincronizzarlo.

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

In Windows utilizza le opzioni di data e ora nel pannello di controllo per configurare l'orologio di sistema.

Torna all'inizio

Per proteggersi dagli attacchi di tipo 'replay' (riproduzione), puoi utilizzare l'ora corrente durante il processo di crittografia/decrittografia. Se l'ora del client e quella del server non corrispondono per un intervallo superiore a quello consentito, il processo può avere esito negativo e la richiesta viene rifiutata. Ciò si può verificare anche quando esegui un comando in una macchina virtuale il cui orologio non è sincronizzato con l'orologio del computer host. Una possibile causa è quando la macchina virtuale va in letargo e dopo il risveglio impiega del tempo per sincronizzare l'orologio con la macchina host.

Su Linux o macOS, esegui date per controllare l'ora.

$ date

Se l'orologio di sistema non viene corretto nel giro di pochi minuti, utilizza ntpd per sincronizzarlo.

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

In Windows utilizza le opzioni di data e ora nel pannello di controllo per configurare l'orologio di sistema.

Torna all'inizio

Se le AWS chiavi includono determinati caratteri speciali, ad esempio-,, o + /%, alcune varianti del sistema operativo elaborano la stringa in modo errato e causano un'interpretazione errata della stringa chiave.

Se elaborate le chiavi utilizzando altri strumenti o script, ad esempio strumenti che creano il file delle credenziali su una nuova istanza durante la sua creazione, tali strumenti e script potrebbero avere una propria gestione dei caratteri speciali che li trasforma in qualcosa che non è più riconoscibile. AWS

Ti consigliamo di rigenerare la chiave segreta per ottenerne una che non includa il carattere speciale che causa problemi.

Torna all'inizio

Testo di errore di esempio:

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

Quando si utilizza un AWS CLI comando, viene visualizzato un messaggio [SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed di errore. Ciò è dovuto al fatto che il certificato del proxy AWS CLI non è considerato attendibile a causa di fattori quali l'autofirma del certificato del proxy e l'autorità di certificazione (CA) della società è stata scelta come Autorità di certificazione (CA). In questo modo non è AWS CLI possibile trovare il certificato principale CA dell'azienda nel registro CA locale.

Per risolvere questo problema, indica AWS CLI dove trovare il file aziendale utilizzando l'impostazione del .pem file di ca_bundle configurazione, l'opzione della riga di --ca-bundle comando o la variabile di AWS_CA_BUNDLE ambiente.

Torna all'inizio

Esempio di testo di errore:

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

Ciò è causato dal fatto che la posizione del file del bundle dell'Autorità di certificazione (CA) non è configurata correttamente in. AWS CLI Per risolvere questo problema, confermate dove si trova il .pem file aziendale e aggiorna la AWS CLI configurazione utilizzando l'impostazione del file di ca_bundle configurazione, l'opzione della riga di --ca-bundle comando o la variabile di AWS_CA_BUNDLE ambiente.

Torna all'inizio

Esempio di testo di errore:

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

Potrebbero verificarsi errori o risultati imprevisti se uno non Servizio AWS è disponibile per i dati specificati Regione AWS o se le risorse si trovano in un altro Regione AWS. Per la risoluzione dei problemi, consulta Verifica che il Regione AWS tuo AWS CLI comando stia usando.

Torna all'inizio

Esempio di testo di errore:

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

Servizio AWS Sta utilizzando una versione TLS incompatibile con la TLS versione del tuo dispositivo. Per risolvere questo problema, esegui l'aggiornamento a una TLS versione supportata. Per ulteriori informazioni, consulta Applicazione di una versione minima di TLS for AWS CLI.

Torna all'inizio

Conferma di aver JSON inserito un valore valido per il tuo comando. Ti consigliamo di utilizzare un JSON validatore JSON se hai problemi di formattazione.

Per un JSON utilizzo più avanzato nella riga di comando, prendi in considerazione l'utilizzo di un JSON processore da riga di comando, ad esempiojq, per creare JSON stringhe. Per maggiori informazioni sujq, consulta il repository jq su. GitHub

Torna all'inizio

Prima di AWS CLI ricevere qualcosa da un comando, il terminale elabora il comando utilizzando le proprie regole di citazione ed escape. A causa delle regole di formattazione di un terminale, alcuni JSON contenuti potrebbero essere rimossi prima che il comando venga passato a. AWS CLI Quando formuli i comandi, assicurati di utilizzare le regole di quotazione del tuo terminale.

Per risolvere i problemi, usa il echo comando per vedere come la shell gestisce i tuoi parametri:

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

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

Modifica il comando finché non viene restituito il comando until validJSON.

Per una risoluzione dei problemi più approfondita, usa il --debug parametro per visualizzare i log di debug in quanto mostreranno esattamente ciò che è stato passato a: 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']

Usa le regole di quotazione del tuo terminale per risolvere eventuali problemi riscontrati dai tuoi JSON input quando vengono inviati a. AWS CLI Per ulteriori informazioni sulle regole di quotazione, vedere. Utilizzo di virgolette e valori letterali con stringhe in AWS CLI

Torna all'inizio