Configura la AWS regione - AWS SDK for .NET

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

AWSLe 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 client Amazon EC2 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

Questo esempio mostra come costruire un nuovo endpoint Region utilizzando. RegionEndpoint GetBySystemName.

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

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 for .NETCerca 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-2
Nota

Se imposti questa variabile di ambiente per l'intero sistema (usando export osetx), avrà effetto su tutti gli SDK e i toolkit, non solo su. AWS SDK for .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 unRegione AWS, i AWS SDK for .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 eweb.config.

  2. Variabili di ambiente (AWS_REGIONeAWS_DEFAULT_REGION).

  3. Un profilo con il nome specificato da un valore inAWSConfigs.AWSProfileName.

  4. Un profilo con il nome specificato dalla variabile di AWS_PROFILE ambiente.

  5. Il [default] profilo.

  6. Metadati dell'istanza Amazon EC2 (se in esecuzione su un'istanza EC2).

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 Regioni AWS non funzioneranno per la Regione Cina (Pechino). Analogamente, gli account e le credenziali della la Regione Cina (Pechino) non funzioneranno per altre Regioni AWS. Per informazioni sugli endpoint e i protocolli disponibili nella regione Cina (Pechino), vedi Beijing Region Endpoints.

Informazioni speciali sui nuovi servizi AWS

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