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à.
# Uso dell'oggetto configurazione globale
È possibile configurare l'SDK in due modi:
+ Impostare l'oggetto configurazione globale tramite `AWS.Config`.
+ Passare le informazioni di configurazione aggiuntive a un oggetto di servizio.
Impostare la configurazione globale con `AWS.Config` è spesso più semplice per iniziare, ma la configurazione a livello di servizio è in grado di garantire un maggiore controllo sui singoli servizi. La configurazione globale specificata da `AWS.Config` offre le impostazioni predefinite per gli oggetti di servizio creati successivamente, semplificando la loro configurazione. Tuttavia, è possibile aggiornare la configurazione di singoli oggetti di servizio quando le esigenze variano a seconda della configurazione globale.
## Impostazione della Configurazione globale
Dopo aver caricato il pacchetto `aws-sdk` nel codice, puoi utilizzare la variabile globale ` AWS` per accedere alle classi dell'SDK e interagire con i singoli servizi. L'SDK include un oggetto di configurazione globale, `AWS.Config`, che puoi utilizzare per specificare le impostazioni di configurazione dell'SDK necessarie per l'applicazione.
Configura l'SDK impostando le proprietà `AWS.Config` in base alle esigenze dell'applicazione. La tabella riportata di seguito riepiloga le proprietà `AWS.Config` comuni per impostare la configurazione dell'SDK.
****
| Opzioni di configurazione | Description |
| --- | --- |
| credentials | Campo obbligatorio. Specifica le credenziali usate per determinare l'accesso a servizi e risorse. |
| region | Campo obbligatorio. Specifica la regione in cui le richieste di servizi sono effettuate. |
| maxRetries | Opzionale. Specifica il numero massimo di volte in cui una determinata richiesta viene rieseguita. |
| logger | Opzionale. Specifica un oggetto logger su cui vengono scritte le informazioni di debug. |
| update | Opzionale. Aggiorna la configurazione corrente con i nuovi valori. |
Per ulteriori informazioni sull'oggetto di configurazione, consulta [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html)l'API Reference.
### Esempi di configurazione globali
È necessario impostare la regione e le credenziali in `AWS.Config`. È possibile impostare queste proprietà come parte del costruttore `AWS.Config`, come illustrato nel seguente script di browser di esempio:
```
var myCredentials = new AWS.CognitoIdentityCredentials({IdentityPoolId:'IDENTITY_POOL_ID'});
var myConfig = new AWS.Config({
credentials: myCredentials, region: 'us-west-2'
});
```
È anche possibile impostare queste proprietà dopo aver creato `AWS.Config` utilizzando il metodo `update`, come nell'esempio seguente, che aggiorna la regione:
```
myConfig = new AWS.Config();
myConfig.update({region: 'us-east-1'});
```
Puoi ottenere le credenziali predefinite chiamando il metodo statico ` getCredentials` di `AWS.config`:
```
var AWS = require("aws-sdk");
AWS.config.getCredentials(function(err) {
if (err) console.log(err.stack);
// credentials not loaded
else {
console.log("Access key:", AWS.config.credentials.accessKeyId);
}
});
```
Allo stesso modo, se avete impostato correttamente la regione nel `config` file, ottenete quel valore impostando che la variabile di `AWS_SDK_LOAD_CONFIG` ambiente sia impostata su un valore qualsiasi e chiamando la `region` proprietà statica di`AWS.config`:
```
var AWS = require("aws-sdk");
console.log("Region: ", AWS.config.region);
```
## Impostazione della configurazione per servizio
Ogni servizio utilizzato nell'SDK per JavaScript è accessibile tramite un oggetto di servizio che fa parte dell'API per quel servizio. Ad esempio, per accedere al servizio Amazon S3 è necessario creare l'oggetto di servizio Amazon S3. È possibile specificare le impostazioni di configurazione specifiche per un servizio come parte del costruttore per quell'oggetto di servizio. Quando si impostano i valori di configurazione su un oggetto di servizio, il costruttore acquisisce tutti i valori di configurazione utilizzati da `AWS.Config`, tra cui le credenziali.
Ad esempio, se devi accedere agli oggetti Amazon EC2 in più regioni, crea un oggetto di servizio Amazon EC2 per ogni regione e imposta di conseguenza la configurazione della regione di ciascun oggetto di servizio.
```
var ec2_regionA = new AWS.EC2({region: 'ap-southeast-2', maxRetries: 15, apiVersion: '2014-10-01'});
var ec2_regionB = new AWS.EC2({region: 'us-east-1', maxRetries: 15, apiVersion: '2014-10-01'});
```
È anche possibile impostare valori di configurazione specifici per un servizio quando si configura l'SDK con `AWS.Config`. L'oggetto di configurazione globale supporta molte opzioni di configurazione specifica del servizio. Per ulteriori informazioni sulla configurazione specifica del servizio, consulta [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html)l'API Reference. AWS SDK per JavaScript
## Dati della configurazione immutabili
Le modifiche della configurazione globale si applicano alle richieste per tutti gli oggetti di servizio appena creati. Gli oggetti di servizio appena creati sono configurati con i dati dell'attuale configurazione globale prima e poi con le opzioni di configurazione locale. Gli aggiornamenti effettuati all'oggetto globale `AWS.config` non vengono applicati agli oggetti di servizio creati in precedenza.
Gli oggetti di servizio esistenti devono essere aggiornati manualmente con i nuovi dati di configurazione oppure è necessario creare e utilizzare un nuovo oggetto di servizio che dispone dei nuovi dati di configurazione. L'esempio seguente crea un nuovo oggetto di servizio Amazon S3 con nuovi dati di configurazione:
```
s3 = new AWS.S3(s3.config);
```