AWSRegion konfigurieren - AWS SDK for .NET

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSRegion konfigurieren

AWSRegionen ermöglichen Ihnen den Zugriff auf AWS Dienste, die sich physisch in einer bestimmten geografischen Region befinden. Dies ist nicht nur für die Redundanz nützlich, sondern sorgt auch dafür, dass Ihre Daten und Anwendungen in der Nähe Ihres Standorts sowie des Standorts Ihrer Benutzer ausgeführt werden.

Eine aktuelle Liste aller unterstützten Regionen und Endpunkte für jeden AWS Dienst finden Sie unter Dienstendpunkte und Kontingente in der. Allgemeine AWS-Referenz Eine Liste der vorhandenen regionalen Endpunkte finden Sie unter AWS Dienstendpunkte. Ausführliche Informationen zu Regionen finden Sie unter Geben Sie an, welche AWS Regionen Ihr Konto verwenden kann.

Sie können einen AWS Service-Client für eine bestimmte Region erstellen. Sie können Ihre Anwendung auch mit einer Region konfigurieren, die für alle AWS Service-Clients verwendet wird. Diese beiden Fälle werden als Nächstes erklärt.

Erstellen Sie einen Service-Client mit einer bestimmten Region

Sie können die Region für jeden der AWS Service-Clients in Ihrer Anwendung angeben. Die Einstellung der Region auf diese Weise hat Vorrang vor allen globalen Einstellungen für diesen bestimmten Service-Client.

Bestehende Region

Dieses Beispiel zeigt Ihnen, wie Sie einen Amazon EC2 EC2-Client in einer vorhandenen Region instanziieren. Es verwendet definierte Felder. RegionEndpoint

using (AmazonEC2Client ec2Client = new AmazonEC2Client(RegionEndpoint.USWest2)) { // Make a request to EC2 in the us-west-2 Region using ec2Client }

Neue Region mit RegionEndpoint Klasse

Dieses Beispiel zeigt Ihnen, wie Sie mithilfe von einen neuen Regionen-Endpunkt erstellen 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 }

Neue Region, die die Service-Client-Konfigurationsklasse verwendet

Dieses Beispiel zeigt, wie Sie die ServiceURL Eigenschaft der Service-Client-Konfigurationsklasse verwenden, um die Region anzugeben. In diesem Fall verwenden Sie die AmazonEC2Config-Klasse.

Diese Technik funktioniert auch dann, wenn der Regions-Endpunkt nicht dem regulären Region-Endpunktmuster folgt.

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 }

Geben Sie eine Region für alle Service-Clients an

Es gibt mehrere Möglichkeiten, eine Region für alle AWS Service-Clients anzugeben, die Ihre Anwendung erstellt. Diese Region wird für Service-Clients verwendet, die nicht mit einer bestimmten Region erstellt wurden.

Der AWS SDK for .NET sucht in der folgenden Reihenfolge nach einem Regionswert.

Profile

Geben Sie ein Profil ein, das Ihre Anwendung oder das SDK geladen hat. Weitere Informationen finden Sie unter Auflösung von Anmeldeinformationen und Profilen.

Umgebungsvariablen

In der AWS_REGION Umgebungsvariablen festgelegt.

Unter Linux oder macOS:

export AWS_REGION='us-west-2'

Unter Windows:

set AWS_REGION=us-west-2
Anmerkung

Wenn Sie diese Umgebungsvariable für das gesamte System festlegen (mit export odersetx), wirkt sich dies auf alle SDKs und Toolkits aus, nicht nur auf. AWS SDK for .NET

AWSConfigs Klasse

Als festgelegt AWSConfigs. AWSRegionEigentum.

AWSConfigs.AWSRegion = "us-west-2"; using (var ec2Client = new AmazonEC2Client()) { // Make request to Amazon EC2 in us-west-2 Region using ec2Client }

Auflösung der Region

Wenn keine der oben beschriebenen Methoden zur Angabe von verwendet wirdAWS-Region, wird AWS SDK for .NET versucht, eine Region zu finden, in der der AWS Service-Client arbeiten soll.

Reihenfolge der Auflösung der Region
  1. Anwendungskonfigurationsdateien wie app.config undweb.config.

  2. Umgebungsvariablen (AWS_REGIONundAWS_DEFAULT_REGION).

  3. Ein Profil mit dem Namen, der durch einen Wert in angegeben wirdAWSConfigs.AWSProfileName.

  4. Ein Profil mit dem durch die AWS_PROFILE Umgebungsvariable angegebenen Namen.

  5. Das [default] Profil.

  6. Amazon EC2 EC2-Instance-Metadaten (wenn sie auf einer EC2-Instance ausgeführt werden).

Wenn keine Region gefunden wird, löst das SDK eine Ausnahme aus, die besagt, dass der AWS Service-Client keine konfigurierte Region hat.

Besondere Informationen über die Region China (Peking)

Um Services in der Region China (Peking) verwenden zu können, benötigen Sie ein Konto und Anmeldeinformationen, die spezifisch für die Region China (Peking) sind. Konten und Anmeldeinformationen für andere AWS-Regionen funktionieren nicht für die Region China (Peking). Ebenso funktionieren Konten und Anmeldeinformationen für die Region China (Peking) nicht für andere AWS-Regionen. Informationen zu Endpunkten und Protokollen, die in der Region China (Peking) verfügbar sind, finden Sie unter Endgeräte in der Region Peking.

Besondere Informationen zu neuen Diensten AWS

Neue AWS Dienste können zunächst in einigen Regionen eingeführt und dann in anderen Regionen unterstützt werden. In diesen Fällen müssen Sie nicht das neueste SDK installieren, um für diesen Dienst auf die neuen Regionen zuzugreifen. Sie können neu hinzugefügte Regionen auf Kundenbasis oder global angeben, wie bereits gezeigt.