Der AWS SDK für .NET V3 ist in den Wartungsmodus übergegangen.
Wir empfehlen Ihnen, auf [AWS SDK für .NET V4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html) zu migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in unserer [Ankündigung zum Wartungsmodus](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/).
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.
# AWS Region konfigurieren
AWS Regionen 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](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) in der. *Allgemeine AWS-Referenz* [Eine Liste der vorhandenen regionalen Endpunkte finden Sie unter AWS Dienstendpunkte.](https://docs.aws.amazon.com/general/latest/gr/rande.html) Ausführliche Informationen zu Regionen finden [Sie unter Geben Sie an, welche AWS Regionen Ihr Konto verwenden kann](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html).
Sie können einen AWS Service-Client für eine [bestimmte Region](#per-client) erstellen. Sie können Ihre Anwendung auch mit einer Region konfigurieren, die für [alle AWS Service-Clients](#globally) 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 [ EC2 Amazon-Client](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/EC2/TEC2Client.html) in einer vorhandenen Region instanziieren. Es verwendet definierte [RegionEndpoint](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TRegionEndpoint.html)Felder.
```
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](https://docs.aws.amazon.com/sdkfornet/v3/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
}
```
### Neue Region, die die Service-Client-Konfigurationsklasse verwendet
Dieses Beispiel zeigt Ihnen, wie Sie die `ServiceURL` Eigenschaft der Service-Client-Konfigurationsklasse verwenden, um die Region anzugeben; in diesem Fall mit der [Amazon EC2 Config-Klasse](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/EC2/TEC2Config.html).
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 für .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](creds-assign.md).
### 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` oder`setx`), wirkt sie sich auf alle SDKs Toolkits aus, nicht nur auf die AWS SDK für .NET.
### AWSConfigs Klasse
Als festgelegt [AWSConfigs. AWSRegion](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TAWSConfigs.html)Eigentum.
```
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 wird AWS-Region, wird AWS SDK für .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` und`web.config`.
1. Umgebungsvariablen (`AWS_REGION`und`AWS_DEFAULT_REGION`).
1. Ein Profil mit dem Namen, der durch einen Wert in angegeben wird`AWSConfigs.AWSProfileName`.
1. Ein Profil mit dem durch die `AWS_PROFILE` Umgebungsvariable angegebenen Namen.
1. Das `[default]` Profil.
1. EC2 Amazon-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 [Endpunkte in der Region Peking](https://docs.amazonaws.cn/en_us/aws/latest/userguide/endpoints-Beijing.html).
## 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.