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:
-
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-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:
-
Se una regione è passata a un costruttore della classe client, viene utilizzata quella regione.
-
Se una regione è impostata nella variabile di ambiente, viene utilizzata quella regione.
-
Altrimenti, viene utilizzata la regione definita nel file di configurazione condiviso.