La guida API di riferimento AWS SDK for JavaScript V3 descrive in dettaglio tutte le API operazioni per la AWS SDK for JavaScript versione 3 (V3).

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

Imposta la AWS regione

Una AWS 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 quando si crea un client di servizio nel modulo SDK in JavaScript modo che SDK acceda al servizio in quella regione. Alcuni servizi sono disponibili solo in regioni specifiche.

SDKPer impostazione predefinita, il for JavaScript non seleziona una regione. Tuttavia, è possibile impostare la AWS regione utilizzando una variabile di ambiente o un config file di configurazione condiviso.

In un costruttore di classi client

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

const s3Client = new S3.S3Client({region: 'us-west-2'});

Usa una variabile di ambiente

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

Usa un file di configurazione condiviso

Proprio come il file delle credenziali condivise consente di archiviare le credenziali da utilizzare da parte diSDK, è possibile conservare la AWS regione e altre impostazioni di configurazione in un file condiviso denominato appositamente config per l'SDKuso. Se la variabile di AWS_SDK_LOAD_CONFIG ambiente è impostata su un valore vero, il comando SDK for cerca JavaScript automaticamente un config file al momento del caricamento. 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-west-2
   output=json

Per ulteriori informazioni sull'utilizzo di credentials file config e file condivisi, consulta File di configurazione e credenziali condivisi nella Guida di riferimento agli strumenti AWS SDKs e agli strumenti.

Ordine di precedenza per l'impostazione della regione

Di seguito è riportato l'ordine di precedenza per l'impostazione della regione: