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
-
Anwendungskonfigurationsdateien wie
app.config
undweb.config
. -
Umgebungsvariablen (
AWS_REGION
undAWS_DEFAULT_REGION
). -
Ein Profil mit dem Namen, der durch einen Wert in angegeben wird
AWSConfigs.AWSProfileName
. -
Ein Profil mit dem durch die
AWS_PROFILE
Umgebungsvariable angegebenen Namen. -
Das
[default]
Profil. -
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.