È stata rilasciata la versione 4 (V4) di\$1 AWS SDK per .NET
Per informazioni su come apportare modifiche e migrare le applicazioni, consulta l'argomento sulla [migrazione](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).
[https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)
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 AWS della regione per AWS SDK per .NET
AWS Le regioni consentono di accedere ai AWS servizi che risiedono fisicamente in un'area geografica specifica. Questa funzionalità può essere utile per la ridondanza e per mantenere i dati e le applicazioni in esecuzione vicino ai punti di accesso ai servizi stessi.
Per visualizzare l'elenco corrente di tutte le regioni e gli endpoint supportati per ogni AWS servizio, consulta [Endpoint e quote del servizio](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) in. *Riferimenti generali di AWS* [Per visualizzare un elenco degli endpoint regionali esistenti, consulta Endpoint di servizio.AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html) Per visualizzare informazioni dettagliate sulle regioni, consulta [Specificare le AWS regioni che il tuo account può utilizzare](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html).
Puoi creare un client AWS di servizio destinato a una [particolare regione](#per-client). È inoltre possibile configurare l'applicazione con una regione che verrà utilizzata per [tutti i client AWS di servizio](#globally). Questi due casi vengono illustrati di seguito.
## Crea un client di servizio con una regione particolare
È possibile specificare la regione per qualsiasi client di AWS servizio nell'applicazione. L'impostazione della regione in questo modo ha la precedenza su qualsiasi impostazione globale per quel particolare client di servizio.
### Regione esistente
Questo esempio mostra come creare un'istanza di un [ EC2 cliente Amazon](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Client.html) in una regione esistente. Utilizza campi definiti [RegionEndpoint](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TRegionEndpoint.html).
```
using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2))
{
// Make a request to EC2 in the us-west-2 Region using ec2Client
}
```
### Nuova regione che utilizza la RegionEndpoint classe
[Questo esempio mostra come costruire un nuovo endpoint Region utilizzando. RegionEndpoint GetBySystemName](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/MRegionEndpointGetBySystemNameString.html).
```
var newRegion = RegionEndpoint.GetBySystemName("us-west-new");
using (var ec2Client = new AmazonEC2Client(newRegion))
{
// Make a request to EC2 in the new Region using ec2Client
}
```
### Nuova regione che utilizza la classe di configurazione del client di servizio
Questo esempio mostra come utilizzare la `ServiceURL` proprietà della classe di configurazione del client di servizio per specificare la regione; in questo caso, utilizzando la classe [Amazon EC2 Config](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/EC2/TEC2Config.html).
Questa tecnica funziona anche se l'endpoint Region non segue il normale modello di endpoint Region.
```
var ec2ClientConfig = new AmazonEC2Config
{
// Specify the endpoint explicitly
ServiceURL = "https://ec2.us-west-new.amazonaws.com"
};
using (var ec2Client = new AmazonEC2Client(ec2ClientConfig))
{
// Make a request to EC2 in the new Region using ec2Client
}
```
## Specificare una regione per tutti i client di servizio
Esistono diversi modi per specificare una regione per tutti i client di AWS servizio creati dall'applicazione. Questa regione viene utilizzata per i client di servizio che non sono stati creati con una regione particolare.
AWS SDK per .NET Cerca un valore Region nell'ordine seguente.
### Profili
Imposta un profilo caricato dall'applicazione o dall'SDK. Per ulteriori informazioni, consulta [Risoluzione di credenziali e profili](creds-assign.md).
### Variabili di ambiente
Impostato nella variabile di `AWS_REGION` ambiente.
Su Linux o macOS
```
export AWS_REGION='us-west-2'
```
In Windows:
```
set AWS_REGION=us-west-2
```
**Nota**
Se impostate questa variabile di ambiente per l'intero sistema (usando `export` or`setx`), avrà effetto su tutti SDKs i toolkit, non solo su. AWS SDK per .NET
### AWSConfigs classe
Impostato come [AWSConfigs. AWSRegion](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/TAWSConfigs.html)proprietà.
```
AWSConfigs.AWSRegion = "us-west-2";
using (var ec2Client = new AmazonEC2Client())
{
// Make request to Amazon EC2 in us-west-2 Region using ec2Client
}
```
## Risoluzione della regione
Se nessuno dei metodi sopra descritti viene utilizzato per specificare un Regione AWS, i AWS SDK per .NET tentativi di trovare una regione in cui il client del AWS servizio possa operare.
**Ordine di risoluzione della regione**
1. File di configurazione dell'applicazione come `app.config` e`web.config`.
1. Variabili di ambiente (`AWS_REGION`e`AWS_DEFAULT_REGION`).
1. Un profilo con il nome specificato da un valore in`AWSConfigs.AWSProfileName`.
1. Un profilo con il nome specificato dalla variabile di `AWS_PROFILE` ambiente.
1. Il `[default]` profilo.
1. Metadati delle EC2 istanze Amazon (se in esecuzione su un' EC2 istanza).
Se non viene trovata alcuna regione, l'SDK genera un'eccezione che indica che il client del AWS servizio non ha una regione configurata.
## Informazioni speciali sulla regione Cina (Pechino)
Per utilizzare i servizi nella Regione Cina (Pechino), devi avere un account e le credenziali specifiche per tale Regione. Gli account e le credenziali di altre AWS regioni non funzioneranno per la regione Cina (Pechino). Allo stesso modo, gli account e le credenziali per la regione Cina (Pechino) non funzioneranno per altre AWS regioni. Per informazioni sugli endpoint e i protocolli disponibili nella regione Cina (Pechino), consulta Beijing Region [Endpoints](https://docs.amazonaws.cn/en_us/aws/latest/userguide/endpoints-Beijing.html).
## Informazioni speciali sui nuovi servizi AWS
AWS I nuovi servizi possono essere lanciati inizialmente in alcune regioni e poi supportati in altre regioni. In questi casi non è necessario installare l'SDK più recente per accedere alle nuove regioni per quel servizio. È possibile specificare le nuove regioni aggiunte per cliente o a livello globale, come illustrato in precedenza.