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à.
# Utilizzo della modalità di aggiornamento di debug per aggiornare la versione AWS CLI 1 alla versione AWS CLI 2
Questo argomento descrive la modalità di debug dell'aggiornamento nella versione 1 della AWS CLI.
Consigliamo agli utenti della AWS CLI versione 1 di eseguire l'aggiornamento alla versione AWS CLI 2 per accedere a nuove funzionalità e prestazioni migliorate. Esistono cambiamenti nel comportamento tra la versione AWS CLI 1 e la versione AWS CLI 2 che potrebbero richiedere l'aggiornamento degli script o dei comandi per ottenere lo stesso comportamento. La modalità di debug di aggiornamento nella versione AWS CLI 1 emette avvisi quando si utilizzano funzionalità che hanno un comportamento diverso nella AWS versione CLI 2. Questa funzionalità migliora l'esperienza di aggiornamento rilevando automaticamente quali comandi della AWS CLI versione 1 devono essere modificati prima dell'aggiornamento alla versione CLI 2 AWS per evitare problemi imprevisti.
Per ulteriori dettagli, vedere in. [Interruzione delle modifiche tra AWS CLI la versione 1 e la AWS CLI versione 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) [Nuove funzionalità e modifiche nella AWS CLI versione 2](cliv2-migration-changes.md)
## Prerequisiti
La funzionalità della modalità di debug di aggiornamento è stata introdotta nella versione AWS CLI. `1.44.0`
Utilizzando la versione AWS CLI 1`aws --version`, esegui e verifica che la versione AWS CLI sia o superiore. `1.44.0`
Se la versione è inferiore a`1.44.0`, consulta [Installazione, aggiornamento e disinstallazione della AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html).
## Come funziona
Se abilitata, la modalità di debug dell'aggiornamento rileva l'utilizzo di funzionalità che sono state aggiornate con modifiche sostanziali nella versione 2 della AWS CLI. Se si utilizza un comando o una funzionalità elencata nel nostro [Interruzione delle modifiche tra AWS CLI la versione 1 e la AWS CLI versione 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking) dopo l'aggiornamento alla versione AWS CLI 2, nell'output verrà visualizzato un avviso. Il rilevamento delle modifiche interrotte si basa sul comando utilizzato, sugli argomenti forniti, sull'ambiente di esecuzione (ad esempio variabili di ambiente, impostazioni di configurazione, ecc.) e, in alcuni casi, sul contenuto o sulla configurazione delle risorse nell' AWS account utilizzato.
Gli avvisi descrivono le azioni per prevenire problemi imprevisti di aggiornamento alla versione 2 della CLI AWS . Dopo aver apportato le modifiche consigliate da un messaggio di avviso, è possibile confermare che il comando è stato aggiornato correttamente eseguendo nuovamente il comando per verificare che l'avviso non venga più visualizzato. Gli avvisi che vengono risolti segnalano che non è più probabile che il comando subisca la modifica definitiva descritta durante l'aggiornamento alla versione CLI 2 AWS .
L'esempio seguente mostra l'aspetto di questi avvisi. Questo comando mostra un esempio di avviso. Tutto il testo di avviso inizia con "AWS CLI V2 UPGRADE WARNING», seguito dal messaggio di avviso specifico. In questo caso, viene emesso un avviso perché il comando si basa sulla AWS CLI per recuperare il contenuto dell'URL e utilizzare il contenuto come valore `--template-body` del parametro, una funzionalità rimossa nella versione AWS CLI 2.
```
$ aws cloudformation create-stack \
--stack-name "stack012345" \
--template-body "https://s3.amazonaws.com/amzn-s3-demo-bucket/template.json"
AWS CLI v2 UPGRADE WARNING: For input parameters that have a prefix of http:// or
https://, AWS CLI v2 will not automatically request the content of the URL for
the parameter, and the `cli_follow_urlparam` option has been removed. See
https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration-changes.html#cliv2-migration-paramfile.
```
La seguente tabella di tutte le modifiche sostanziali e di come evitare di dover affrontare modifiche sostanziali nella versione AWS CLI 2. Le azioni correttive che risolvono gli avvisi in modalità debug sono in grassetto.
| Cambiamento decisivo | Sulla v1, esegui la migrazione al comportamento v2 | Sulla v2, mantieni il comportamento v1 |
| --- | --- | --- |
| [Aggiunta di una variabile di ambiente per impostare la codifica dei file di testo](cliv2-migration-changes.md#cliv2-migration-encodingenvvar) | Annulla l'impostazione delle variabili di PYTHONUTF8 ambiente. PYTHONIOENCODING | Imposta la variabile di AWS\$1CLI\$1FILE\$1ENCODING ambiente sulla codifica specificata in v1. |
| [Per impostazione predefinita, i parametri binari vengono passati come stringhe con codifica Base64.](cliv2-migration-changes.md#cliv2-migration-binaryparam) | Codifica il valore del parametro con base64. Se il parametro viene caricato da un file, codificate il contenuto del file con base64. | Imposta l'impostazione su. cli\$1binary\$1format raw-in-base64-out |
| [Gestione migliorata delle proprietà e dei tag dei file per copie in più parti in Amazon S3](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata) | N/A. Impossibile migrare al comportamento della versione 2 nella versione 1. | Utilizzo del parametro --copy-props none. |
| [Nessun recupero automatico di `http://` o per i parametri `https://` URLs](cliv2-migration-changes.md#cliv2-migration-paramfile) | Usa curl (o strumenti alternativi) per scaricare il contenuto di in un file locale URLs . Quindi, carica il contenuto del file nel parametro con [file://](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-file.html). In alternativa, configurate su false cli\$1follow\$1urlparam per specificare l'URL non elaborato come valore del parametro. | N/A. Impossibile mantenere il comportamento della versione 1 nella versione 2. |
| [Pager utilizzato per impostazione predefinita per tutto l’output](cliv2-migration-changes.md#cliv2-migration-output-pager) | N/A. Impossibile migrare al comportamento della versione 2 nella versione 1. | Imposta l'cli\$1pagerimpostazione o la AWS\$1PAGER variabile su una stringa vuota. |
| [I valori di output del timestamp sono standardizzati sul formato ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp) | Imposta l'impostazione cli\$1timestamp \$1format suiso8601. | Imposta l'cli\$1timestamp\$1formatimpostazione su wire. |
| [Migliore gestione delle CloudFormation distribuzioni che non comportano modifiche](cliv2-migration-changes.md#cliv2-migration-cfn) | Usa il --no-fail-on-empty-changeset parametro. | Utilizzo del parametro --fail-on-empty-changeset. |
| [Modifica del comportamento predefinito per l’endpoint Amazon S3 regionale per la Regione `us-east-1`](cliv2-migration-changes.md#cliv2-migration-s3-regional-endpoint) | Imposta la variabile di AWS\$1ENDPOINT\$1URL\$1S3 ambiente o l'opzione della riga di --endpoint-url comando sull'URL regionale [us-east-1](https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_region). | Usa l'opzione della --region aws-global riga di comando. |
| [`ecr get-login` rimosso e sostituito con `ecr get-login-password`](cliv2-migration-changes.md#cliv2-migration-ecr-get-login) | (1.17.10 o successivo) Usa [`ecr get-login` rimosso e sostituito con `ecr get-login-password`](cliv2-migration-changes.md#cliv2-migration-ecr-get-login) e reindirizza l'output a un comando docker. | N/A. Impossibile mantenere il comportamento della versione 1 nella versione 2. |
| [AWS CLI il supporto della versione 2 per i plugin sta cambiando](cliv2-migration-changes.md#cliv2-migration-profile-plugins) | N/A. Impossibile migrare al comportamento della versione 2 nella versione 1. | Configura [cli\$1legacy\$1plugin\$1path nella sezione del file](https://docs.aws.amazon.com/cli/latest/topic/config-vars.html#plugins) di configurazione. [plugins] Prova i plugin nella versione 2, blocca la versione 2 e testa i plugin ogni volta che esegui l'aggiornamento. |
| [Rimozione del supporto per gli alias nascosti](cliv2-migration-changes.md#cliv2-migration-aliases) | Passa dall'uso dell'alias nascosto obsoleto a [Rimozione del supporto per gli alias nascosti](cliv2-migration-changes.md#cliv2-migration-aliases) quello che funziona in tutte le versioni. | N/A. Impossibile mantenere il comportamento della versione 1 nella versione 2. |
| [L’impostazione del file di configurazione `api_versions` non è supportata](cliv2-migration-changes.md#cliv2-migration-api-versions) | Migra e testa l'utilizzo delle versioni API precedenti alla versione API più recente e rimuovi [api\$1versions](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-api_versions) dalle impostazioni di configurazione. | N/A. Impossibile mantenere il comportamento della versione 1 nella versione 2. |
| [AWS CLI la versione 2 utilizza solo Signature v4 per autenticare le richieste Amazon S3](cliv2-migration-changes.md#cliv2-migration-sigv4) | Specificare la versione della firma nella versione 4 (vedere [Specificazione della versione della firma nella richiesta](https://docs.aws.amazon.com/AmazonS3/latest/API/specify-signature-version.html) di autenticazione). | N/A. Impossibile mantenere il comportamento della versione 1 nella versione 2. |
| [AWS CLI la versione 2 è più coerente con i parametri di paging](cliv2-migration-changes.md#cliv2-migration-skeleton-paging) | Sposta i parametri di impaginazione nel parametro JSON di input nel comando stesso. | Rimuovi i parametri di impaginazione dal parametro JSON di input. |
| [AWS CLI la versione 2 fornisce codici di ritorno più coerenti per tutti i comandi](cliv2-migration-changes.md#cliv2-migration-return-codes) | N/A. Impossibile migrare al comportamento della versione 2 nella versione 1. | N/A. Impossibile mantenere il comportamento della versione 1 nella versione 2. |
## Limitazioni
Consigliamo vivamente ai clienti di recensire il nostro. [Interruzione delle modifiche tra AWS CLI la versione 1 e la AWS CLI versione 2](cliv2-migration-changes.md#cliv2-migration-changes-breaking)
### Rilevamento di Breaking Change non supportato
La funzionalità della modalità di debug di aggiornamento supporta tutte le modifiche sostanziali tranne quella. [AWS CLI la versione 2 fornisce codici di ritorno più coerenti per tutti i comandi](cliv2-migration-changes.md#cliv2-migration-return-codes) Questa modalità non può tenere conto del modo in cui utilizzi i codici di errore restituiti dalla AWS CLI downstream.
### Rilevamento condizionale delle modifiche di interruzione
Il rilevamento di [I valori di output del timestamp sono standardizzati sul formato ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp) è l'unico caso in cui il rilevamento dipende dallo stato dell' AWS account e può essere soggetto a modifiche sostanziali se le risorse dell'account vengono aggiornate in un secondo momento. Se nella risposta API del servizio non è incluso alcun timestamp, non verrà effettuata alcuna rilevazione di questa modifica sostanziale.
Se ti affidi al formato timestamp restituito dai comandi AWS CLI e non hai già configurato la AWS CLI per utilizzare ISO 8601, prendi ulteriori precauzioni per assicurarti che l'elaborazione del timestamp non si interrompa dopo l'aggiornamento alla versione 2.
### Rilevamento di modifiche irrisolvibili
Alcuni avvisi emessi dalla modalità di debug dell'aggiornamento non possono essere risolti modificando il comando o l'ambiente. I casi seguenti sono casi in cui gli avvisi verrebbero sempre emessi dalla modalità di debug dell'aggiornamento purché si utilizzi la funzionalità corrispondente:
+ [AWS CLI il supporto della versione 2 per i plugin sta cambiando](cliv2-migration-changes.md#cliv2-migration-profile-plugins)- se ci si affida ai plugin nel [file di configurazione](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html), la modalità di debug dell'aggiornamento emetterà sempre un avviso che non può essere risolto. Questa modalità non può garantire che uno dei tuoi plugin funzioni nella versione AWS CLI 2.
+ [Gestione migliorata delle proprietà e dei tag dei file per copie in più parti in Amazon S3](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata)- se `aws s3` viene utilizzato per eseguire una copia di bucket-to-bucket Amazon Amazon S3, la modalità di debug dell'upgrade emetterà sempre un avviso che non può essere risolto.
### Falsi rilevamenti
Gli avvisi emessi dalla modalità di debug dell'aggiornamento non garantiscono che vengano apportate modifiche sostanziali dopo l'aggiornamento a AWS CLI v2. Di seguito sono riportati i casi in cui gli avvisi verrebbero emessi dalla modalità di debug di aggiornamento, nonostante non sia stata introdotta alcuna modifica sostanziale in CLI v2 AWS :
+ [Aggiunta di una variabile di ambiente per impostare la codifica dei file di testo](cliv2-migration-changes.md#cliv2-migration-encodingenvvar)- se le variabili `PYTHONUTF8` o di `PYTHONIOENCODING` ambiente sono specificate per impostare la codifica del file di testo e la codifica specificata corrisponde già alla locale installata, l'avviso potrebbe essere un falso rilevamento poiché la modalità di debug non verifica se la codifica corrisponde alla locale installata.
+ [Gestione migliorata delle proprietà e dei tag dei file per copie in più parti in Amazon S3](cliv2-migration-changes.md#cliv2-migration-s3-copy-metadata)- se `aws s3` viene utilizzato per eseguire una copia di bucket-to-bucket Amazon Amazon S3 e la copia non è multiparte perché l'oggetto di origine è al di sotto della [soglia multiparte, verrà emesso](https://docs.aws.amazon.com/cli/latest/topic/s3-config.html#multipart-threshold) un falso rilevamento.
+ [I valori di output del timestamp sono standardizzati sul formato ISO 8601](cliv2-migration-changes.md#cliv2-migration-timestamp)- se l'impostazione di configurazione cli\$1timestamp\$1format è impostata su wire (impostazione predefinita) e il servizio restituisce un timestamp in formato ISO 8601.
+ [Migliore gestione delle CloudFormation distribuzioni che non comportano modifiche](cliv2-migration-changes.md#cliv2-migration-cfn)- se il `--fail-on-empty-changeset` flag viene utilizzato con il `aws cloudformation deploy` comando e il changeset risultante è vuoto, verrà emesso un falso rilevamento. Inoltre, se il changeset non è vuoto e non viene utilizzato, `--no-fail-on-empty-changeset` verrà emesso un falso rilevamento.
+ [Modifica del comportamento predefinito per l’endpoint Amazon S3 regionale per la Regione `us-east-1`](cliv2-migration-changes.md#cliv2-migration-s3-regional-endpoint)- se `aws s3` o `aws s3api` viene utilizzato per eseguire un'operazione Amazon S3 e la regione è configurata a livello regionale e la `s3.us_east_1_regional_endpoint` configurazione non è configurata a `us-east-1` livello regionale e l'endpoint Amazon S3 globale viene utilizzato per la richiesta a causa delle impostazioni di [configurazione dell'endpoint, l'avviso potrebbe essere un falso rilevamento, poiché la modalità di debug non verifica le impostazioni degli endpoint](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-endpoints.html#endpoints-precedence) configurati.
## Configura la modalità di debug per l'aggiornamento
È possibile abilitare o disabilitare la modalità di debug dell'aggiornamento utilizzando i seguenti metodi, elencati in ordine di precedenza:
+ Le opzioni della riga di comando abilitano o disabilitano la modalità di debug dell'aggiornamento per un singolo comando. Usa [--v2-debug per usare la modalità di debug](https://docs.aws.amazon.com/cli//latest/userguide/cli-configure-options.html#cli-configure-options-v2-debug) di aggiornamento.
+ [Le variabili di ambiente utilizzano la variabile \$1UPGRADE\$1DEBUG\$1MODE. AWS\$1CLI](https://docs.aws.amazon.com/cli//latest/userguide/cli-configure-envvars.html#envvars-list-aws_cli_upgrade_debug_mode)