

La AWS SDK per JavaScript v2 è arrivata. end-of-support [Ti consigliamo di migrare alla AWS SDK per JavaScript v3.](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) [Per ulteriori dettagli e informazioni su come effettuare la migrazione, consulta questo annuncio.](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)

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

# Impostazione della regione AWS
<a name="setting-region"></a>

Una regione è un insieme denominato di AWS risorse nella stessa area geografica. Un esempio di regione è `us-east-1` la regione degli Stati Uniti orientali (Virginia settentrionale). Si specifica una regione durante la configurazione dell'SDK in JavaScript modo che l'SDK acceda alle risorse in quella regione. Alcuni servizi sono disponibili solo in Regioni specifiche.

L'SDK per JavaScript non seleziona una regione per impostazione predefinita. Tuttavia, è possibile impostare la regione utilizzando una variabile di ambiente, un file `config` condiviso o l'oggetto di configurazione globale.

## In un costruttore della classe client
<a name="setting-region-constructor"></a>

Quando si crea un'istanza di un oggetto di servizio, è possibile specificare la regione per la risorsa come parte del costruttore della classe client, come illustrato qui.

```
var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});
```

## Uso dell'oggetto configurazione globale
<a name="setting-region-config-object"></a>

Per impostare la regione nel JavaScript codice, aggiorna l'oggetto di configurazione `AWS.Config` globale come mostrato qui.

```
AWS.config.update({region: 'us-east-1'});
```

Per ulteriori informazioni sulle regioni attuali e sui servizi disponibili in ciascuna regione, consulta [AWS Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html) in. *Riferimenti generali di AWS*

## Utilizzo di una variabile di ambiente
<a name="setting-region-environment-variable"></a>

È possibile impostare la regione utilizzando la variabile di ambiente `AWS_REGION`. Se definisci questa variabile, l'SDK for la JavaScript legge e la utilizza.

## Utilizzo di un file di configurazione condiviso
<a name="setting-region-config-file"></a>

Proprio come il file delle credenziali condivise consente di archiviare le credenziali per l'utilizzo da parte dell'SDK, è possibile conservare la regione e altre impostazioni di configurazione in un file condiviso denominato `config` utilizzato da. SDKs Se la variabile di `AWS_SDK_LOAD_CONFIG` ambiente è stata impostata su un valore qualsiasi, l'SDK cerca JavaScript automaticamente un `config` file al momento del caricamento. Il percorso di salvataggio del file ` config` varia a seconda del sistema operativo:
+ Utenti Linux, macOS o Unix: `~/.aws/config`
+ Utenti Windows: `C:\Users\USER_NAME\.aws\config`

Se non si dispone già di un file condiviso `config`, è possibile crearne uno nella directory designata. In questo esempio il file `config` imposta sia la regione sia il formato di output.

```
[default]
   region=us-east-1
   output=json
```

*Per ulteriori informazioni sull'utilizzo dei file di configurazione e credenziali condivisi, consulta [Caricamento delle credenziali su Node.js dal file delle credenziali condiviso](loading-node-credentials-shared.md) la sezione File di [configurazione e credenziali](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) nella Guida per l'utente.AWS Command Line Interface *

## Ordine di precedenza per l'impostazione della regione
<a name="setting-region-order-of-precedence"></a>

L'ordine di precedenza per l'impostazione della regione è il seguente:
+ Se una regione è passata a un costruttore della classe client, viene utilizzata quella regione. In caso contrario, allora...
+ Se una regione è impostata sull'oggetto di configurazione globale, viene utilizzata quella regione. In caso contrario, allora...
+ Se la variabile di ambiente `AWS_REGION` è un valore [truthy](https://developer.mozilla.org/en-US/docs/Glossary/Truthy), viene utilizzata quella regione. In caso contrario, allora...
+ Se la variabile di ambiente `AMAZON_REGION` è un valore truthy, viene utilizzata quella regione. In caso contrario, allora...
+ Se la variabile di `AWS_SDK_LOAD_CONFIG` ambiente è impostata su un valore qualsiasi e il file delle credenziali condivise (`~/.aws/credentials`o il percorso indicato da`AWS_SHARED_CREDENTIALS_FILE`) contiene una regione per il profilo configurato, viene utilizzata tale regione. In caso contrario, allora...
+ Se la variabile di `AWS_SDK_LOAD_CONFIG` ambiente è impostata su un valore qualsiasi e il file di configurazione (`~/.aws/config`o il percorso indicato da`AWS_CONFIG_FILE`) contiene una regione per il profilo configurato, viene utilizzata tale regione.