Abbiamo annunciato l'imminente uscita end-of-support per la AWS SDK for JavaScript v2. Ti consigliamo di migrare alla AWS SDK for JavaScript v3. Per date, dettagli aggiuntivi e informazioni su come effettuare la migrazione, consulta l'annuncio collegato.

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

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

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

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 in. Riferimenti generali di AWS

Utilizzo di una variabile di ambiente

È 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

Proprio come il file delle credenziali condiviso consente di archiviare le credenziali che saranno utilizzate dall'SDK, è possibile conservare la regione e le altre impostazioni di configurazione in un file condiviso denominato config che viene utilizzato dagli SDK. Se la variabile di AWS_SDK_LOAD_CONFIG ambiente è stata impostata su un valore qualsiasi, l'SDK cerca JavaScript automaticamente un config file quando viene caricato. Il percorso di salvataggio del file config varia a seconda del sistema operativo:

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 la sezione File di configurazione e credenziali nella Guida per l'utente.AWS Command Line Interface

Ordine di precedenza per l'impostazione della regione

L'ordine di precedenza per l'impostazione della regione è il seguente: