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 delle variabili di ambiente in un'applicazione Amplify
<a name="environment-variables"></a>

Le variabili di ambiente sono coppie chiave-valore che puoi aggiungere alle impostazioni dell'applicazione per renderle disponibili ad Amplify Hosting. Come best practice, è possibile utilizzare le variabili di ambiente per esporre i dati di configurazione dell'applicazione. Tutte le variabili di ambiente aggiunte sono crittografate per impedire accessi non autorizzati.

Amplify applica i seguenti vincoli alle variabili di ambiente create.
+ Amplify non consente di creare nomi di variabili di ambiente con un prefisso. `AWS` Questo prefisso è riservato solo per uso interno di Amplify.
+ Il valore di una variabile di ambiente non può superare i 5500 caratteri.

**Importante**  
Non utilizzare variabili di ambiente per memorizzare segreti. Per un'app di seconda generazione, utilizza la funzionalità di **gestione segreta** nella console Amplify. Per ulteriori informazioni, consulta [Secrets and environment vars nella documentazione](https://docs.amplify.aws/react/deploy-and-host/fullstack-branching/secrets-and-vars/) di *Amplify.* Per un'app di prima generazione, archivia i segreti in un ambiente segreto creato utilizzando Parameter Store. AWS Systems Manager Per ulteriori informazioni, consulta [Gestione dei segreti ambientali](environment-secrets.md).

## Riferimento alla variabile di ambiente Amplify
<a name="amplify-console-environment-variables"></a>

Le seguenti variabili di ambiente sono accessibili per impostazione predefinita all'interno della console Amplify.


****  

| Nome della variabile | Description | Valore di esempio | 
| --- | --- | --- | 
|  \$1BUILD\$1TIMEOUT  |  La durata del timeout di compilazione in minuti. Il valore minimo è 5. Il valore massimo è 120.  |  `30`  | 
|  \$1LIVE\$1UPDATES  |  Lo strumento verrà aggiornato alla versione più recente.  |  `[{"name":"Amplify CLI","pkg":"@aws-amplify/cli","type":"npm","version":"latest"}]`  | 
|  USER\$1DISABLE\$1TESTS  |  La fase di test viene saltata durante la compilazione. Puoi disabilitare i test per tutte le filiali o per quelle specifiche di un'app. Questa variabile di ambiente viene utilizzata per le app che eseguono test durante la fase di compilazione. Per ulteriori informazioni sull'impostazione di questa variabile, vedere[Disattivazione dei test per un'applicazione o un ramo Amplify](running-tests.md#disabling-tests).  |  `true`  | 
|  AWS\$1APP\$1ID  |  ID dell'applicazione della compilazione corrente  |  `abcd1234`  | 
|  AWS\$1BRANCH  |  Nome del ramo della compilazione corrente  |  `main`, `develop`, `beta`, `v2.0`  | 
|  AWS\$1BRANCH\$1ARN  |  La filiale Amazon Resource Name (ARN) della build corrente  | `aws:arn:amplify:us-west-2:123456789012:appname/branch/... ` | 
|  AWS\$1CLONE\$1URL  |  URL di clonazione utilizzato per recuperare i contenuti del repository git  |   `git@github.com:<user-name>/<repo-name>.git`   | 
|  AWS\$1COMMIT\$1ID  |  L'ID di commit della build corrente «HEAD» per le ricostruzioni  |  `abcd1234`  | 
|  AWS\$1JOB\$1ID  |  ID processo della compilazione corrente. Questo include una certa imbottitura di '0' in modo che abbia sempre la stessa lunghezza.  |  `0000000001`  | 
|  AWS\$1PULL\$1REQUEST\$1ID  |  L'ID della pull request della build di anteprima web della pull request. Questa variabile di ambiente non è disponibile quando viene utilizzata AWS CodeCommit come provider di repository.  |  `1`  | 
|  AWS\$1PULL\$1REQUEST\$1SOURCE\$1BRANCH  |  Il nome del feature branch per l'anteprima di una pull request inviata a un ramo dell'applicazione nella console Amplify.  |  `featureA`  | 
|  AWS\$1PULL\$1REQUEST\$1DESTINATION\$1BRANCH  |  Il nome del ramo dell'applicazione nella console Amplify a cui viene inviata una richiesta pull del feature branch.  |  `main`  | 
|  AMPLIFY\$1AMAZON\$1CLIENT\$1ID  |  L'ID client Amazon  |  `123456`  | 
|  AMPLIFY\$1AMAZON\$1CLIENT\$1SECRET  |  Il segreto del cliente Amazon  |  `example123456`  | 
|  AMPLIFY\$1FACEBOOK\$1CLIENT\$1ID  |  L'ID del client di Facebook  |  `123456`  | 
|  AMPLIFY\$1FACEBOOK\$1CLIENT\$1SECRET  |  Il segreto del client di Facebook  |  `example123456`  | 
|  AMPLIFY\$1GOOGLE\$1CLIENT\$1ID  |  L'ID del client Google  |  `123456`  | 
|  AMPLIFY\$1GOOGLE\$1CLIENT\$1SECRET  |  Il segreto del client Google  |  `example123456`  | 
|  AMPLIFY\$1DIFF\$1DEPLOY  |  Abilita o disabilita la distribuzione frontend basata su diff. Per ulteriori informazioni, consulta [Configurazione della compilazione e della distribuzione del frontend basato su diff](edit-build-settings.md#enable-diff-deploy).  |  `true`  | 
|  AMPLIFY\$1DIFF\$1DEPLOY\$1ROOT  |  Il percorso da utilizzare per i confronti delle distribuzioni frontend basate su diff, rispetto alla radice del repository.  | `dist` | 
|  AMPLIFY\$1DIFF\$1BACKEND  |  Abilita o disabilita le build di backend basate su diff. Questo vale solo per le app di prima generazione. Per ulteriori informazioni, consulta [Configurazione di build di backend basate su diff per un'app di prima generazione](edit-build-settings.md#enable-diff-backend)  | `true` | 
|  AMPLIFY\$1BACKEND\$1PULL\$1ONLY  |  Amplify gestisce questa variabile d'ambiente. Questo vale solo per le app di prima generazione. Per ulteriori informazioni, consulta [Modifica un frontend esistente in modo che punti a un backend diverso](reuse-backends.md#reuse-backends-edit-existing)  | `true` | 
|  AMPLIFY\$1BACKEND\$1APP\$1ID  |  Amplify gestisce questa variabile d'ambiente. Questo vale solo per le app di prima generazione. Per ulteriori informazioni, consulta [Modifica un frontend esistente in modo che punti a un backend diverso](reuse-backends.md#reuse-backends-edit-existing)  | `abcd1234` | 
|  AMPLIFY\$1SKIP\$1BACKEND\$1BUILD  |  Se non hai una sezione di backend nelle specifiche della build e desideri disabilitare le build di backend, imposta questa variabile di ambiente su. `true` Questo vale solo per le app di prima generazione.  | `true` | 
|  AMPLIFY\$1ENABLE\$1DEBUG\$1OUTPUT  |  Imposta questa variabile su `true` per stampare una traccia dello stack nei log. Questo è utile per il debug degli errori di compilazione del backend.  | `true` | 
|  AMPLIFY\$1MONOREPO\$1APP\$1ROOT  |  Il percorso da utilizzare per specificare la radice dell'app di un'app monorepo, relativa alla radice del repository.  | `apps/react-app` | 
|  AMPLIFY\$1USERPOOL\$1ID  |  L'ID per il pool di utenti di Amazon Cognito importato per l'autenticazione  |  `us-west-2_example`  | 
|  AMPLIFY\$1WEBCLIENT\$1ID  |  L'ID del client dell'app che deve essere utilizzato dalle applicazioni Web Il client dell'app deve essere configurato con l'accesso al pool di utenti di Amazon Cognito specificato dalla variabile di ambiente AMPLIFY\$1USERPOOL\$1ID.  | `123456` | 
|  AMPLIFY\$1NATIVECLIENT\$1ID  |  L'ID del client dell'app che deve essere utilizzato dalle applicazioni native Il client dell'app deve essere configurato con l'accesso al pool di utenti di Amazon Cognito specificato dalla variabile di ambiente AMPLIFY\$1USERPOOL\$1ID.  | `123456` | 
|  AMPLIFY\$1IDENTITYPOOL\$1ID  |  L'ID per il pool di identità di Amazon Cognito  |  `example-identitypool-id`  | 
|  AMPLIFY\$1PERMISSIONS\$1BOUNDARY\$1ARN  |  L'ARN per la policy IAM da utilizzare come limite di autorizzazioni che si applica a tutti i ruoli IAM creati da Amplify.  |  `arn:aws:iam::123456789012:policy/example-policy`  | 
|  AMPLIFY\$1DESTRUCTIVE\$1UPDATES  |  Imposta questa variabile di ambiente su true per consentire l'aggiornamento di un'API GraphQL con operazioni di schema che possono potenzialmente causare la perdita di dati.  |  `true`  | 

**Nota**  
Le variabili `AMPLIFY_AMAZON_CLIENT_ID` di `AMPLIFY_AMAZON_CLIENT_SECRET` ambiente sono OAuth token, non una chiave di AWS accesso e una chiave segreta. 

## Variabili di ambiente del framework frontend
<a name="frontend-framework-environment-variables"></a>

Se stai sviluppando la tua app con un framework frontend che supporta le proprie variabili di ambiente, è importante capire che queste non sono le stesse variabili di ambiente che configuri nella console Amplify. Ad esempio, React (prefisso REACT\$1APP) e Gatsby (prefisso GATSBY), consentono di creare variabili di ambiente di runtime che tali framework raggruppano automaticamente nella build di produzione del frontend. Per comprendere gli effetti dell'utilizzo di queste variabili di ambiente per memorizzare valori, consulta la documentazione del framework di frontend che stai utilizzando.

La memorizzazione di valori sensibili, come le chiavi API, all'interno di queste variabili di ambiente con prefisso del framework di frontend non è una buona pratica ed è altamente sconsigliata.