Risoluzione degli errori per AWS CLI

Esempio di testo dell’errore:

$ aws s3 copy
aws: [ERROR]: argument operation: Found invalid choice 'copy'

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

  aws help
  aws <command> help
  aws <command> <subcommand> help

Se il comando è formattato in modo errato o se utilizzi una versione precedente al rilascio della funzionalità, possono verificarsi diversi errori. Per ulteriori informazioni sulla risoluzione degli errori relativi a questi due problemi, consulta Controlla la formattazione dei comandi AWS CLI e Verifica di disporre di una versione recente della AWS CLI.

Torna all’inizio

Esempio di testo dell’errore:

$ 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

Esempio di testo dell’errore:

$ aws --version
command not found: aws

Se il aws comando non viene trovato dopo la prima installazione o l'aggiornamento di AWS CLI, è possibile che non sia stato installato completamente. Prova a reinstallarla seguendo le fasi specifiche per la piattaforma in uso riportate in Installazione o aggiornamento dell’ultima versione 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

Esempio di testo dell’errore:

$ 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 comando aws mostra la versione errata, potrebbe essere necessario riavviare il terminale in modo che riconosca gli aggiornamenti della variabile PATH. Tutti i terminali aperti devono essere chiusi, non solo quello attivo.

Torna all’inizio

Se il comando aws mostra la versione errata e il riavvio del terminale non ha funzionato, potrebbe essere necessario riavviare il sistema per far sì che riconosca gli aggiornamenti della variabile 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 hai utilizzato pip per l’installazione corrente, ma hai provato a eseguire l’aggiornamento utilizzando il file di installazione .pkg, è possibile che si verifichino alcuni conflitti, soprattutto con la variabile PATH che punta alla versione precedente.

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

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

Torna all’inizio

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

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 hai utilizzato pip per l’installazione corrente, devi utilizzare pip anche per la disinstallazione. Per risolvere il problema, esegui la disinstallazione AWS CLI utilizzando lo stesso metodo utilizzato per l'installazione.

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 comando 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

Quando l’abbreviazione può essere utilizzata per più comandi, il parametro non viene riconosciuto come abbreviazione.

Il seguente esempio di comando modifica il nome dello CloudFormation stack. Il parametro --change-set- non è riconosciuto come abbreviazione poiché potrebbe essere un’abbreviazione di più parametri, ad esempio --change-set-name e --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 programma aws disponga delle autorizzazioni di esecuzione per l’utente che effettua la chiamata. In genere, le autorizzazioni sono impostate su 755.

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

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

Torna all’inizio

Esempio di testo dell’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 account o a un ruolo IAM. Le policy associate devono concedere l’autorizzazione per chiamare le operazioni API corrispondenti ai comandi eseguiti con la 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 multiple APIs. È 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 delle autorizzazioni IAM, consulta Panoramica della gestione degli accessi: autorizzazioni e policy nella Guida per l’utente di 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 : ****************ABCD : shared-credentials-file : 
secret_key : ****************ABCD : shared-credentials-file : 
region     : us-west-2            : env                     : AWS_DEFAULT_REGION

L'esempio seguente mostra come controllare le credenziali di un profilo denominato.

$ aws configure list --profile dev01
NAME       : VALUE                : TYPE                    : LOCATION
profile    : dev01                : None                    : --profile
access_key : ****************ABCD : shared-credentials-file : 
secret_key : ****************ABCD : shared-credentials-file : 
region     : us-west-2            : config-file             : ~/.aws/config

Per verificare i dettagli della tua coppia di chiavi, controlla i file credentials e config. Per ulteriori informazioni sui file config e credentials, consulta Impostazioni dei file di configurazione e delle credenziali nella AWS CLI. Per ulteriori informazioni sulle credenziali e sull’autenticazione, inclusa la precedenza delle credenziali, consulta Credenziali di autenticazione e accesso per la 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 replay, è possibile utilizzare l'ora corrente durante il encryption/decryption processo. 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 è legata al caso in cui la macchina virtuale entra in stato di ibernazione e l’intervallo richiesto per la sua riattivazione e la successiva sincronizzazione dell’orologio con il computer host risulta eccessivo.

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 suggeriamo di rigenerare la chiave segreta in modo da ottenerne una in cui non è presente il carattere speciale che causa problemi.

Torna all’inizio

Esempio di testo dell’errore:

$ 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 affidabile a causa di fattori quali l'autofirma del certificato del proxy e l'autorità di certificazione (CA) della società. Ciò impedisce alla AWS CLI di trovare il certificato principale CA della società nel registro CA locale.

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

Torna all’inizio

Esempio di testo dell’errore:

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

Ciò è dovuto al fatto che la posizione del file del bundle della CA non è configurata correttamente nella AWS CLI. Per risolvere questo problema, indica alla .pem la posizione in cui trovare il file AWS CLI della società utilizzando l’impostazione del file di configurazione ca_bundle, l’opzione della riga di comando --ca-bundle o la variabile di ambiente AWS_CA_BUNDLE.

Torna all’inizio

Esempio di testo dell’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 AWS CLI comando Regione AWS stia usando il tuo comando.

Torna all’inizio

Esempio di testo dell’errore:

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

Servizio AWS Sta utilizzando una versione di TLS incompatibile con la versione TLS del dispositivo. Per risolvere il problema, esegui l’aggiornamento a una versione di TLS supportata. Per ulteriori informazioni, consulta Applicazione di una versione minima di TLS 1.2 per AWS CLI.

Torna all’inizio

Verifica di aver inserito codice JSON valido per il comando. Se riscontri problemi di formattazione del codice JSON, ti suggeriamo di utilizzare un validatore JSON.

Per un utilizzo più avanzato del codice JSON su una riga di comando, prendi in considerazione l’utilizzo di un processore JSON a riga di comando, ad esempio jq, per creare stringhe JSON. Per ulteriori 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, parte del contenuto JSON potrebbe essere rimosso prima che il comando venga passato alla AWS CLI. Quando formuli i comandi, assicurati di applicare le regole di utilizzo delle virgolette del terminale.

Per risolvere il problema, utilizza il comando echo per vedere in che modo i parametri vengono gestiti dalla shell:

$ 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 codice JSON valido.

Per una risoluzione dei problemi più approfondita, utilizza il parametro --debug per visualizzare i log di debug che mostreranno i dati esatti passati alla 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']

Applica le regole di utilizzo delle virgolette del terminale per risolvere eventuali problemi riscontrati dall’input JSON quando viene inviato alla AWS CLI. Per ulteriori informazioni sulle regole di utilizzo delle virgolette, consulta Utilizzo di virgolette e valori letterali con stringhe nella AWS CLI.

Torna all’inizio