La versione 4 (V4) di SDK per .NET è disponibile in anteprima! Per visualizzare le informazioni su questa nuova versione in anteprima, consulta la Guida per gli sviluppatori AWS SDK per .NET (anteprima della versione 4).
Tieni presente che la versione 4 dell'SDK è in anteprima, pertanto il suo contenuto è soggetto a modifiche.
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à.
Configura la AWS regione
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 in. Riferimenti generali di AWS Per visualizzare un elenco degli endpoint regionali esistenti, consulta Endpoint di servizio.AWS Per visualizzare informazioni dettagliate sulle regioni, consulta Specificare le AWS regioni che il tuo account può utilizzare.
Puoi creare un client AWS di servizio destinato a una particolare regione. È inoltre possibile configurare l'applicazione con una regione che verrà utilizzata per tutti i client AWS di servizio. 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 in una regione esistente. Utilizza campi definiti RegionEndpoint.
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
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.
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.
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-2Nota
Se impostate questa variabile di ambiente per l'intero sistema (usando export orsetx), avrà effetto su tutti SDKs i toolkit, non solo su. SDK per .NET
AWSConfigs classe
Impostato come AWSConfigs. AWSRegionproprietà.
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 SDK per .NET tentativi di trovare una regione in cui il client del AWS servizio possa operare.
Ordine di risoluzione della regione
-
File di configurazione dell'applicazione come
app.configeweb.config. -
Variabili di ambiente (
AWS_REGIONeAWS_DEFAULT_REGION). -
Un profilo con il nome specificato da un valore in
AWSConfigs.AWSProfileName. -
Un profilo con il nome specificato dalla variabile di
AWS_PROFILEambiente. -
Il
[default]profilo. -
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
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.
