**Questa documentazione è valida AWS CLI solo per la versione 1.** Abbiamo annunciato l' end-of-supportimminente rilascio della AWS CLI versione 1. Ti consigliamo di migrare alla AWS CLI versione 2. [Per date, dettagli aggiuntivi e informazioni su come effettuare la migrazione, consulta l'annuncio.](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/) Per la documentazione relativa alla versione 2 di AWS CLI, consulta la [Guida per l'utente della versione 2](https://docs.aws.amazon.com/cli/latest/userguide/). Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Risoluzione degli errori relativi a AWS CLI Questa sezione tratta gli errori comuni e le procedure di risoluzione dei problemi da seguire per risolvere un problema. Ti consigliamo di iniziare con i [suggerimenti generali per la risoluzione dei problemi](#tshoot-general). **Contents** + [Risoluzione generale dei problemi come primo tentativo](#tshoot-general) + [Controlla la formattazione dei comandi AWS CLI](#general-formatting) + [Verifica che AWS CLI comando Regione AWS stia usando il tuo comando](#general-region) + [Conferma che stai utilizzando una versione recente di AWS CLI](#general-latest) + [Utilizza l’opzione `--debug`](#general-debug) + [Abilita e rivedi i registri della cronologia dei AWS CLI comandi](#tshoot-general-history) + [Conferma che il tuo AWS CLI è configurato](#tshoot-general-config) + [Errori di comando non trovato](#tshoot-install-not-found) + [Il comando `aws --version` restituisce una versione diversa da quella installata](#tshoot-install-wrong-version) + [Il comando "`aws --version`" restituisce una versione dopo la disinstallazione di AWS CLI](#tshoot-uninstall-1) + [Hanno AWS CLI elaborato un comando con un nome di parametro incompleto](#tshoot-parameter-abbrev) + [Errori di accesso negato](#tshoot-access-denied) + [Credenziali non valide ed errori delle chiavi](#tshoot-permissions-wrongcreds) + [Errori di firma non corrispondente](#tshoot-signature-does-not-match) + [Errori di console Windows non trovata](#tshoot-no-windows-console-found) + [Errori di certificato SSL](#tshoot-certificate-verify-failed) + [Errori JSON non validi](#tshoot-invalid-json) + [Risorse aggiuntive](#tshoot-resources) ## Risoluzione generale dei problemi come primo tentativo Se ricevi un errore o riscontri un problema con il AWS CLI, ti suggeriamo i seguenti suggerimenti generali per aiutarti a risolverlo. [Torna all’inizio](#cli-chap-troubleshooting-top) ### Controlla la formattazione dei comandi AWS CLI Se ricevi un errore in cui viene segnalato che un comando non esiste o che non viene riconosciuto un parametro (`Parameter validation failed`) indicato nella documentazione come disponibile, è possibile che il comando sia formattato in modo errato. Ti suggeriamo di controllare quanto segue: + Controlla la presenza di errori di ortografia e formattazione nel comando. + Verifica che [tutte le virgolette e tutti i caratteri di escape appropriati per il terminale](cli-usage-parameters-quoting-strings.md) siano riportati correttamente nel comando. + Genera uno [scheletro della AWS CLI](cli-usage-skeleton.md) per verificare la struttura del comando. + Per JSON, consulta la sezione aggiuntiva sulla [risoluzione dei problemi relativi ai valori JSON](#tshoot-invalid-json). Se riscontri problemi con l’elaborazione della formattazione JSON nel terminale, ti suggeriamo di ignorare le regole di utilizzo delle virgolette del terminale utilizzando [Blob per passare i dati JSON direttamente alla AWS CLI](cli-usage-parameters-types.md#parameter-type-blob). Per ulteriori informazioni su come deve essere strutturato un comando specifico, consulta la guida di [AWS CLI riferimento AWS CLI versione 2 della guida](https://docs.aws.amazon.com/cli/v1/reference/) . [Torna all’inizio](#cli-chap-troubleshooting-top) ### Verifica che AWS CLI comando Regione AWS stia usando il tuo comando **Nota** È necessario specificare un valore Regione AWS quando si utilizza la AWS CLI, in modo esplicito o impostando una regione predefinita. Per un elenco di tutto ciò Regioni AWS che è possibile specificare, consulta [AWS Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html) in. *Riferimenti generali di Amazon Web Services* I Regione AWS designatori utilizzati da AWS CLI sono gli stessi nomi che vedi negli Console di gestione AWS URLs endpoint del servizio. 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 In ordine di precedenza, Regione AWS viene impostato nei seguenti modi: + Opzione della riga di comando `--region` + Variabile di ambiente `AWS\$1DEFAULT\$1REGION` + Impostazione del profilo [`region`](cli-configure-files.md#cli-config-region) Conferma di utilizzare quello corretto Regione AWS per le tue risorse. [Torna all’inizio](#cli-chap-troubleshooting-top) ### Conferma che stai utilizzando una versione recente di AWS CLI Se ricevi un errore che indica che un comando non esiste o che non riconosce un parametro che la guida di [AWS CLI riferimento alla AWS CLI versione 2 della guida](https://docs.aws.amazon.com/cli/v1/reference/) indica disponibile, verifica innanzitutto che il comando sia formattato correttamente. Se la formattazione è corretta, ti consigliamo di eseguire l’aggiornamento alla versione più recente della AWS CLI. Le versioni aggiornate di AWS CLI vengono rilasciate quasi ogni giorno lavorativo. AWS Nuovi servizi, funzionalità e parametri vengono introdotti in queste nuove versioni di AWS CLI. L'unico modo per ottenere l'accesso a questi nuovi servizi, caratteristiche o parametri è eseguire l'aggiornamento a una versione rilasciata dopo che l'elemento è stato introdotto per la prima volta. La modalità di aggiornamento della versione di AWS CLI dipende da come è stata originariamente installata, come descritto in [Installazione, aggiornamento e disinstallazione della AWS CLI](cli-chap-install.md). Se hai utilizzato uno dei programmi di installazione in bundle, potresti dover rimuovere l’installazione esistente e quindi scaricare e installare la versione più recente per il sistema operativo in uso. [Torna all’inizio](#cli-chap-troubleshooting-top) ### Utilizza l’opzione `--debug` Quando AWS CLI riporta un errore che non comprendi immediatamente o produce risultati inaspettati, puoi ottenere maggiori dettagli sull'errore eseguendo nuovamente il comando con l'`--debug`opzione. Con questa opzione, la AWS CLI restituisce i dettagli di ogni fase di elaborazione del comando. I dettagli riportati nell’output possono aiutarti a determinare quando si è verificato l’errore e fornire spunti sul contesto in cui ha avuto origine. Puoi trasferire l’output in un file di testo per esaminarlo in un secondo momento o per inviarlo al Supporto AWS quando richiesto. Quando utilizzi l’opzione `--debug`, tra i dettagli sono inclusi: + Ricerca delle credenziali + Analisi dei parametri specificati + Costruzione della richiesta inviata ai server AWS + Il contenuto della richiesta inviata a AWS + Il contenuto della risposta non elaborata + L'output formattato Ecco un esempio di un comando eseguito con e senza l’opzione `--debug`. ``` $ aws iam list-groups --profile MyTestProfile { "Groups": [ { "Path": "/", "GroupName": "MyTestGroup", "GroupId": "AGPA0123456789EXAMPLE", "Arn": "arn:aws:iam::123456789012:group/MyTestGroup", "CreateDate": "2019-08-12T19:34:04Z" } ] } ``` ``` $ aws iam list-groups --profile MyTestProfile --debug 2019-08-12 12:36:18,305 - MainThread - awscli.clidriver - DEBUG - CLI version: aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205 2019-08-12 12:36:18,305 - MainThread - awscli.clidriver - DEBUG - Arguments entered to CLI: ['iam', 'list-groups', '--debug'] 2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,307 - MainThread - botocore.credentials - DEBUG - Skipping environment variable credential check because profile name was explicitly set. 2019-08-12 12:36:18,307 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler 2019-08-12 12:36:18,308 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/service-2.json 2019-08-12 12:36:18,317 - MainThread - botocore.hooks - DEBUG - Event building-command-table.iam: calling handler 2019-08-12 12:36:18,320 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/waiters-2.json 2019-08-12 12:36:18,321 - MainThread - awscli.clidriver - DEBUG - OrderedDict([('path-prefix', ), ('marker', ), ('max-items', )]) 2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,326 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/paginators-1.json 2019-08-12 12:36:18,326 - MainThread - awscli.customizations.paginate - DEBUG - Modifying paging parameters for operation: ListGroups 2019-08-12 12:36:18,326 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler 2019-08-12 12:36:18,326 - MainThread - botocore.hooks - DEBUG - Event before-building-argument-table-parser.iam.list-groups: calling handler > 2019-08-12 12:36:18,327 - MainThread - botocore.hooks - DEBUG - Event before-building-argument-table-parser.iam.list-groups: calling handler > 2019-08-12 12:36:18,327 - MainThread - botocore.hooks - DEBUG - Event operation-args-parsed.iam.list-groups: calling handler functools.partial(, ['marker', 'max-items'], {'max-items': }, OrderedDict([('path-prefix', ), ('marker', ), ('max-items', ), ('cli-input-json', ), ('starting-token', ), ('page-size', ), ('generate-cli-skeleton', )])) 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.path-prefix: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.marker: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.max-items: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.cli-input-json: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.starting-token: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.page-size: calling handler 2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.generate-cli-skeleton: calling handler 2019-08-12 12:36:18,329 - MainThread - botocore.hooks - DEBUG - Event calling-command.iam.list-groups: calling handler > 2019-08-12 12:36:18,329 - MainThread - botocore.hooks - DEBUG - Event calling-command.iam.list-groups: calling handler > 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: assume-role 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: assume-role-with-web-identity 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: shared-credentials-file 2019-08-12 12:36:18,329 - MainThread - botocore.credentials - INFO - Found credentials in shared credentials file: ~/.aws/credentials 2019-08-12 12:36:18,330 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/endpoints.json 2019-08-12 12:36:18,334 - MainThread - botocore.hooks - DEBUG - Event choose-service-name: calling handler 2019-08-12 12:36:18,337 - MainThread - botocore.hooks - DEBUG - Event creating-client-class.iam: calling handler 2019-08-12 12:36:18,337 - MainThread - botocore.regions - DEBUG - Using partition endpoint for iam, us-west-2: aws-global 2019-08-12 12:36:18,337 - MainThread - botocore.args - DEBUG - The s3 config key is not a dictionary type, ignoring its value of: None 2019-08-12 12:36:18,340 - MainThread - botocore.endpoint - DEBUG - Setting iam timeout as (60, 60) 2019-08-12 12:36:18,341 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/_retry.json 2019-08-12 12:36:18,341 - MainThread - botocore.client - DEBUG - Registering retry handlers for service: iam 2019-08-12 12:36:18,342 - MainThread - botocore.hooks - DEBUG - Event before-parameter-build.iam.ListGroups: calling handler 2019-08-12 12:36:18,342 - MainThread - botocore.hooks - DEBUG - Event before-call.iam.ListGroups: calling handler 2019-08-12 12:36:18,343 - MainThread - botocore.endpoint - DEBUG - Making request for OperationModel(name=ListGroups) with params: {'url_path': '/', 'query_string': '', 'method': 'POST', 'headers': {'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8', 'User-Agent': 'aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205'}, 'body': {'Action': 'ListGroups', 'Version': '2010-05-08'}, 'url': 'https://iam.amazonaws.com/', 'context': {'client_region': 'aws-global', 'client_config': , 'has_streaming_input': False, 'auth_type': None}} 2019-08-12 12:36:18,343 - MainThread - botocore.hooks - DEBUG - Event request-created.iam.ListGroups: calling handler > 2019-08-12 12:36:18,343 - MainThread - botocore.hooks - DEBUG - Event choose-signer.iam.ListGroups: calling handler 2019-08-12 12:36:18,343 - MainThread - botocore.auth - DEBUG - Calculating signature using v4 auth. 2019-08-12 12:36:18,343 - MainThread - botocore.auth - DEBUG - CanonicalRequest: POST / content-type:application/x-www-form-urlencoded; charset=utf-8 host:iam.amazonaws.com x-amz-date:20190812T193618Z content-type;host;x-amz-date 5f776d91EXAMPLE9b8cb5eb5d6d4a787a33ae41c8cd6eEXAMPLEca69080e1e1f 2019-08-12 12:36:18,344 - MainThread - botocore.auth - DEBUG - StringToSign: AWS4-HMAC-SHA256 20190812T193618Z 20190812/us-east-1/iam/aws4_request ab7e367eEXAMPLE2769f178ea509978cf8bfa054874b3EXAMPLE8d043fab6cc9 2019-08-12 12:36:18,344 - MainThread - botocore.auth - DEBUG - Signature: d85a0EXAMPLEb40164f2f539cdc76d4f294fe822EXAMPLE18ad1ddf58a1a3ce7 2019-08-12 12:36:18,344 - MainThread - botocore.endpoint - DEBUG - Sending http request: 2019-08-12 12:36:18,344 - MainThread - urllib3.util.retry - DEBUG - Converted retries value: False -> Retry(total=False, connect=None, read=None, redirect=0, status=None) 2019-08-12 12:36:18,344 - MainThread - urllib3.connectionpool - DEBUG - Starting new HTTPS connection (1): iam.amazonaws.com:443 2019-08-12 12:36:18,664 - MainThread - urllib3.connectionpool - DEBUG - https://iam.amazonaws.com:443 "POST / HTTP/1.1" 200 570 2019-08-12 12:36:18,664 - MainThread - botocore.parsers - DEBUG - Response headers: {'x-amzn-RequestId': '74c11606-bd38-11e9-9c82-559da0adb349', 'Content-Type': 'text/xml', 'Content-Length': '570', 'Date': 'Mon, 12 Aug 2019 19:36:18 GMT'} 2019-08-12 12:36:18,664 - MainThread - botocore.parsers - DEBUG - Response body: b'\n \n false\n \n \n /\n MyTestGroup\n arn:aws:iam::123456789012:group/MyTestGroup\n AGPA1234567890EXAMPLE\n 2019-08-12T19:34:04Z\n \n \n \n \n 74c11606-bd38-11e9-9c82-559da0adb349\n \n\n' 2019-08-12 12:36:18,665 - MainThread - botocore.hooks - DEBUG - Event needs-retry.iam.ListGroups: calling handler 2019-08-12 12:36:18,665 - MainThread - botocore.retryhandler - DEBUG - No retry needed. 2019-08-12 12:36:18,665 - MainThread - botocore.hooks - DEBUG - Event after-call.iam.ListGroups: calling handler { "Groups": [ { "Path": "/", "GroupName": "MyTestGroup", "GroupId": "AGPA123456789012EXAMPLE", "Arn": "arn:aws:iam::123456789012:group/MyTestGroup", "CreateDate": "2019-08-12T19:34:04Z" } ] } ``` [Torna all’inizio](#cli-chap-troubleshooting-top) ### Abilita e rivedi i registri della cronologia dei AWS CLI comandi È possibile abilitare i registri della cronologia dei AWS CLI comandi utilizzando l'impostazione del `cli\$1history` file. Dopo aver abilitato questa impostazione, AWS CLI registra la cronologia dei `aws` comandi. Puoi generare l’elenco della cronologia utilizzando il comando `aws history list` e utilizzare il valore di command\$1ids risultante nel comando `aws history show` per i dettagli. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/cli/v1/reference/history/index.html](https://docs.aws.amazon.com/cli/v1/reference/history/index.html) nella *Guida di riferimento della AWS CLI *. Quando utilizzi l’opzione `--debug`, tra i dettagli sono inclusi: + Chiamate API effettuate a botocore + Codici di stato + Risposte HTTP + Headers + Codici restituiti Puoi utilizzare queste informazioni per verificare che i dati dei parametri e le chiamate API si comportino nel modo previsto e quindi dedurre in quale fase del processo viene generato l’errore del comando. [Torna all’inizio](#cli-chap-troubleshooting-top) ### Conferma che il tuo AWS CLI è configurato Se il tuo utente o ruolo IAM oppure i tuoi file `credentials` e `config` non sono configurati correttamente, possono verificarsi diversi errori. Per ulteriori informazioni sulla risoluzione degli errori relativi ai file `credentials` e `config` oppure all’utente o ai ruoli IAM, consulta [Errori di accesso negato](#tshoot-access-denied) e [Credenziali non valide ed errori delle chiavi](#tshoot-permissions-wrongcreds). [Torna all’inizio](#cli-chap-troubleshooting-top) ## Errori di comando non trovato Questo errore indica che il sistema operativo non riesce a trovare il AWS CLI comando. L’installazione potrebbe essere incompleta o deve essere aggiornata. **Possibile causa: stai cercando di utilizzare una AWS CLI funzionalità più recente della versione installata o hai una formattazione errata** *Esempio di testo dell’errore:* ``` $ aws s3 copy aws: [ERROR]: argument operation: Found invalid choice 'copy' usage: aws [options] [ ...] [parameters] To see help text, you can run: aws help aws help aws 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](#general-formatting) e [Conferma che stai utilizzando una versione recente di AWS CLI](#general-latest). [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: il terminale deve essere riavviato dopo l’installazione** *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](#cli-chap-troubleshooting-top) **Possibile causa: l'installazione AWS CLI non è stata completata** *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, aggiornamento e disinstallazione della AWS CLI](cli-chap-install.md). [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: AWS CLI non dispone di autorizzazioni (Linux)** 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](https://en.wikipedia.org/wiki/Chmod)` le autorizzazioni a: AWS CLI ``` $ sudo chmod -R 755 /usr/local/aws-cli/ ``` [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: la variabile `PATH` del sistema operativo non è stata aggiornata durante l’installazione** *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 tuo`PATH`, usa le seguenti istruzioni per il tuo sistema operativo. 1. Individua lo script del profilo della shell nella directory utente. Se non hai la certezza di quale sia la tua shell, esegui `echo $SHELL`. ``` $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads ``` + **Bash** - `.bash_profile`, `.profile` o `.bash_login` + **Zsh** – `.zshrc` + **Tcsh** - `.tcshrc`, `.cshrc` o `.login` 1. Aggiungi un comando di esportazione allo script del tuo profilo. Il comando seguente aggiunge il contenitore locale alla variabile `PATH` corrente. ``` export PATH=/usr/local/bin:$PATH ``` 1. Ricarica il profilo aggiornato nella sessione corrente. ``` $ source ~/.bash_profile ``` 1. In un prompt dei comandi di Windows, utilizza il comando `where` con il parametro `/R path` per trovare la posizione del file `aws`. I risultati restituiti includono tutte le cartelle contenenti `aws`. ``` C:\> where /R c:\ aws c:\Program Files\Amazon\AWSCLIV2\aws.exe ... ``` Per impostazione predefinita, la AWS CLI versione 2 si trova in: ``` c:\Program Files\Amazon\AWSCLIV2\aws.exe ``` 1. Premere il tasto Windows e immettere **environment variables**. 1. Dall’elenco di suggerimenti, seleziona **Modifica variabili di ambiente per l’account**. 1. Seleziona **PATH**, quindi scegli **Modifica**. 1. Nel campo **Valore variabile**, aggiungi il percorso trovato nel primo passaggio, ad esempio ***C:\$1Program Files\$1Amazon\$1AWSCLIV2\$1aws.exe***. 1. Fai doppio clic su **OK** per applicare le nuove impostazioni. 1. Chiudi tutte le richieste di comando in esecuzione e riapri la finestra del prompt dei comandi. [Torna all’inizio](#cli-chap-troubleshooting-top) ## Il comando `aws --version` restituisce una versione diversa da quella installata Il tuo terminale potrebbe restituire un `PATH` messaggio diverso AWS CLI da quello previsto. **Possibile causa: il terminale deve essere riavviato dopo l’installazione** 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](#cli-chap-troubleshooting-top) **Possibile causa: il sistema deve essere riavviato dopo l’installazione** 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](#cli-chap-troubleshooting-top) **Possibile causa: sono disponibili più versioni di AWS CLI** 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](#tshoot-uninstall-multiple-version) 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](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) o della [AWS CLI versione 2](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Se ciò accade dopo aver installato la AWS CLI versione 2 con un'installazione preesistente della AWS CLI versione 1, segui le istruzioni di migrazione contenute nelle Istruzioni di [installazione durante la migrazione dalla AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration-instructions.html) versione 1. [Torna all’inizio](#cli-chap-troubleshooting-top) ## Il comando "`aws --version`" restituisce una versione dopo la disinstallazione di AWS CLI Ciò si verifica spesso quando ne è ancora AWS CLI installato uno da qualche parte sul sistema. **Possibile causa: il terminale deve essere riavviato dopo la disinstallazione** Se il comando `aws --version` funziona ancora, potrebbe essere necessario riavviare il terminale per far sì che riconosca eventuali aggiornamenti. [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: AWS CLI sul sistema sono presenti più versioni di o non è stato utilizzato lo stesso metodo di disinstallazione utilizzato originariamente per l'installazione di AWS CLI** 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. 1. Segui le istruzioni appropriate per il sistema operativo in uso e per il metodo di installazione utilizzato originariamente per disinstallare la [AWS CLI versione 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) e la [AWS CLI versione 2](https://docs.aws.amazon.com/cli/latest/userguide/uninstall.html). 1. Chiudi tutti i terminali aperti. 1. Apri il tuo terminale preferito, inserisci il seguente comando e verifica che non venga restituita alcuna versione. ``` $ aws --version command not found: aws ``` Se nell'output è ancora presente una versione, è probabile che sia AWS CLI stata installata utilizzando un metodo diverso o che esistano più versioni. Se non sai quale metodo hai installato AWS CLI, segui le istruzioni per ogni metodo di disinstallazione per la [AWS CLI versione 1 e la AWS CLI versione](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) [2](https://docs.aws.amazon.com/cli/latest/userguide/uninstall.html) appropriati al tuo sistema operativo fino a quando non viene ricevuta alcuna versione in uscita. **Nota** Se per installare la AWS CLI hai utilizzato un gestore di pacchetti (`pip`, `apt`, `brew` e così via), devi utilizzare lo stesso gestore di pacchetti per disinstallarla. Assicurati di seguire le istruzioni fornite dal gestore di pacchetti su come disinstallare tutte le relative versioni. [Torna all’inizio](#cli-chap-troubleshooting-top) ## Hanno AWS CLI elaborato un comando con un nome di parametro incompleto **Possibile causa: è stata utilizzata un’abbreviazione riconosciuta del parametro AWS CLI ** Poiché AWS CLI è stato creato utilizzando Python, AWS CLI utilizza la `argparse` libreria Python, incluso l'argomento. [https://docs.python.org/3/library/argparse.html#allow-abbrev](https://docs.python.org/3/library/argparse.html#allow-abbrev) Le abbreviazioni dei parametri vengono riconosciute da ed elaborate AWS CLI . Il seguente esempio di [https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html](https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html)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 [https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html](https://docs.aws.amazon.com/cli/v1/reference/cloudformation/create-change-set.html)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 ``` **Non** utilizzare intenzionalmente le abbreviazioni dei parametri. Non sono affidabili e non sono retrocompatibili. Se ai comandi vengono aggiunti nuovi parametri che rendono dubbie le abbreviazioni, i comandi vengono interrotti. Inoltre, se il parametro è un argomento a valore singolo, può causare un comportamento imprevisto dei comandi. Se vengono passate più istanze di un argomento a valore singolo, viene eseguita solo l’ultima istanza. Nell’esempio seguente, il parametro `--filters` è un argomento a valore singolo. Sono specificati entrambi i parametri `--filters` e `--filter`. Il parametro `--filter` è l’abbreviazione di `--filters`. Ciò comporterebbe l’applicazione di due istanze di `--filters`, ma in realtà viene applicato solo l’ultimo argomento `--filter`. ``` $ aws ec2 describe-vpc-peering-connections \ --filters Name=tag:TagName,Values=VpcPeeringConnection \ --filter Name=status-code,Values=active ``` Prima di eseguire un comando, verifica di utilizzare parametri validi per evitare comportamenti imprevisti. [Torna all’inizio](#cli-chap-troubleshooting-top) ## Errori di accesso negato **Possibile causa: il file di AWS CLI programma non dispone del permesso di «esecuzione»** 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 *\$1/.local/bin/aws* con il percorso del programma sul tuo computer. ``` $ chmod +x ~/.local/bin/aws ``` [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: l’identità IAM non dispone dell’autorizzazione per eseguire l’operazione** *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'`--debug`opzione. 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](#tshoot-permissions-wrongcreds) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_access-management.html) nella *Guida per l’utente di IAM*. [Torna all’inizio](#cli-chap-troubleshooting-top) ## Credenziali non valide ed errori delle chiavi *Esempio di testo dell’errore:* ``` $ aws s3 ls An error occurred (InvalidAccessKeyId) when calling the ListBuckets operation: The AWS Access Key Id you provided does not exist in our records. ``` ``` $ aws s3 ls An error occurred (InvalidClientTokenId) when calling the ListBuckets operation: The security token included in the request is invalid. ``` **Possibile causa: AWS CLI sta leggendo credenziali errate o da una posizione inaspettata** È 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 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 Name Value Type Location ---- ----- ---- -------- profile None None access_key ****************ABCD shared-credentials-file secret_key ****************ABCD shared-credentials-file region us-west-2 env AWS_DEFAULT_REGION ``` 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 credenziali in AWS CLI](cli-configure-files.md). Per ulteriori informazioni sulle credenziali e sull’autenticazione, inclusa la precedenza delle credenziali, consulta [Credenziali di autenticazione e accesso per AWS CLI](cli-chap-authentication.md). [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: l’orologio del computer non è sincronizzato** 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](#cli-chap-troubleshooting-top) ## Errori di firma non corrispondente *Esempio di testo dell’errore:* ``` $ aws s3 ls An error occurred (SignatureDoesNotMatch) when calling the ListBuckets operation: The request signature we calculated does not match the signature you provided. Check your key and signing method. ``` Quando AWS CLI esegue un comando, invia una richiesta crittografata ai AWS server per eseguire le operazioni di AWS servizio appropriate. Le credenziali (la chiave di accesso e la chiave segreta) sono coinvolte nella crittografia e AWS consentono l'autenticazione della persona che effettua la richiesta. Ci sono diversi aspetti che possono interferire con il corretto funzionamento di questo processo, come illustrato di seguito: **Possibile causa: l'orologio non è sincronizzato con i server AWS ** Per proteggersi dagli [attacchi replay](https://wikipedia.org/wiki/Replay_attack), è 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](#cli-chap-troubleshooting-top) **Possibile causa: il sistema operativo sta gestendo male AWS le chiavi che contengono determinati caratteri speciali** 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](#cli-chap-troubleshooting-top) ## Errori di console Windows non trovata *Esempio di testo dell’errore:* ``` $ aws s3 ls No Windows console found. Are you running cmd.exe? ``` Quando si utilizza un AWS CLI comando, viene visualizzato il messaggio «Nessuna console Windows trovata». Are you running cmd.exe?” come messaggio di errore. Questo di solito è un errore visualizzato per la AWS CLI versione 1 se il Python `prompt_toolkit` che hai installato non è aggiornato. Per risolvere questo problema, installa una versione recente del `prompt_toolkit` disponibile sul sito web di [Python](https://pypi.org/project/prompt-toolkit/). [Torna all’inizio](#cli-chap-troubleshooting-top) ## Errori di certificato SSL **Possibile causa: AWS CLI non si fida del certificato del proxy** *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\$1bundle` configurazione, l'opzione della riga di **[--ca-bundle](cli-configure-options.md#cli-configure-options-ca-bundle)** comando o la `AWS\$1CA\$1BUNDLE` variabile di ambiente. [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: la configurazione non punta alla posizione corretta del certificato root della CA** *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\$1bundle`, l’opzione della riga di comando **[--ca-bundle](cli-configure-options.md#cli-configure-options-ca-bundle)** o la variabile di ambiente `AWS\$1CA\$1BUNDLE`. [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: la tua configurazione non utilizza il codice corretto Regione AWS** *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](#general-region). [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: la versione di TLS deve essere aggiornata ** *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 per AWS CLI](cli-security-enforcing-tls.md). [Torna all’inizio](#cli-chap-troubleshooting-top) ## Errori JSON non validi *Esempio di testo dell’errore:* ``` $ aws dynamodb update-table \ --provisioned-throughput '{"ReadCapacityUnits":15,WriteCapacityUnits":10}' \ --table-name MyDDBTable Error parsing parameter '--provisioned-throughput': Invalid JSON: Expecting property name enclosed in double quotes: line 1 column 25 (char 24) JSON received: {"ReadCapacityUnits":15,WriteCapacityUnits":10} ``` Quando si utilizza un AWS CLI comando, viene visualizzato un messaggio di errore `Invalid JSON` "». Di solito si tratta di un errore visualizzato quando si immette un comando con un formato JSON previsto e AWS CLI non è possibile leggere correttamente il codice JSON. **Possibile causa: non hai inserito un codice JSON valido da utilizzare AWS CLI ** 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 su`jq`, consulta il [repository jq](http://stedolan.github.io/jq/) su. *GitHub* [Torna all’inizio](#cli-chap-troubleshooting-top) **Possibile causa: le regole di quotazione del terminale impediscono l'invio di un codice JSON valido a AWS CLI** 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](cli-usage-parameters-quoting-strings.md). 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 in AWS CLI](cli-usage-parameters-quoting-strings.md). Se hai problemi a inserire un codice JSON valido su AWS CLI, ti consigliamo di aggirare le regole di quotazione di un terminale per l'immissione di dati JSON utilizzando Blobs per passare i dati JSON direttamente a. AWS CLI Per ulteriori informazioni sui Blob, consulta [Blob](cli-usage-parameters-types.md#parameter-type-blob). [Torna all’inizio](#cli-chap-troubleshooting-top) ## Risorse aggiuntive [https://github.com/aws/aws-cli/issues](https://github.com/aws/aws-cli/issues) [Torna all’inizio](#cli-chap-troubleshooting-top)