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
Anmerkung
Hilfe zum Verständnis des Layouts von Einstellungsseiten oder zur Interpretation der folgenden Tabelle mit Unterstützung durch AWS SDKs und Tools finden Sie unterDie Einstellungsseiten dieses Handbuchs verstehen.
AWS-Regionen sind ein wichtiges Konzept, das Sie verstehen sollten, wenn Sie damit AWS-Services arbeiten.
Mit AWS-Regionen können Sie auf AWS-Services das zugreifen, was sich physisch in einem bestimmten geografischen Gebiet befindet. Dies kann nützlich sein, um Ihre Daten und Anwendungen in der Nähe der Stelle laufen zu lassen, an der Sie und Ihre Benutzer auf sie zugreifen werden. Regionen bieten Fehlertoleranz, Stabilität und Ausfallsicherheit und können auch die Latenz verkürzen. Mit Regions können Sie redundante Ressourcen erstellen, die verfügbar bleiben und von einem regionalen Ausfall nicht betroffen sind.
Die meisten AWS-Service Anfragen beziehen sich auf eine bestimmte geografische Region. Die Ressourcen, die Sie in einer Region erstellen, existieren in keiner anderen Region, es sei denn, Sie verwenden ausdrücklich eine Replikationsfunktion, die von einer angeboten wird AWS-Service. Beispielsweise unterstützen Amazon S3 und Amazon EC2 die regionsübergreifende Replikation. Einige Dienste, wie z. B. IAM, verfügen nicht über regionale Ressourcen.
Das Allgemeine AWS-Referenz enthält Informationen zu folgenden Themen:
-
Informationen zur Beziehung zwischen Regionen und Endpunkten sowie eine Liste der vorhandenen regionalen Endpunkte finden Sie unter AWS Dienstendpunkte.
-
Die aktuelle Liste aller unterstützten Regionen und Endpunkte für jede Region finden Sie unter Dienstendpunkte und AWS-Service Kontingente.
Service-Clients erstellen
Für den programmgesteuerten Zugriff AWS-Services verwenden SDKs jeweils einen Client class/object . AWS-Service Wenn Ihre Anwendung beispielsweise auf Amazon EC2 zugreifen muss, erstellt Ihre Anwendung ein Amazon EC2-Client-Objekt als Schnittstelle zu diesem Service.
Wenn im Code selbst keine Region explizit für den Client angegeben ist, verwendet der Client standardmäßig die Region, die durch die folgende Einstellung festgelegt wird. region Die aktive Region für einen Client kann jedoch explizit für jedes einzelne Client-Objekt festgelegt werden. Das Festlegen der Region auf diese Weise hat Vorrang vor allen globalen Einstellungen für diesen bestimmten Service-Client. Die alternative Region wird bei der Instanziierung dieses Clients angegeben und ist spezifisch für Ihr SDK (lesen Sie in Ihrem spezifischen SDK-Handbuch oder in der Codebasis Ihres SDK nach).
Konfigurieren Sie diese Funktion mithilfe der folgenden Optionen:
region- Einstellung für gemeinsam genutzte AWSconfigDateienAWS_REGION- Umgebungsvariableaws.region- JVM-Systemeigenschaft: nur Java/Kotlin-
Gibt den Standard AWS-Region an, der für AWS Anfragen verwendet werden soll. Diese Region wird für SDK-Serviceanfragen verwendet, für die keine bestimmte Region zur Verwendung angegeben ist.
Standardwert: Keiner. Sie müssen diesen Wert explizit angeben.
Zulässige Werte:
-
Jeder der für den ausgewählten Dienst verfügbaren Regionscodes, wie er in der AWS Allgemeinen Referenz unter AWS Dienstendpunkte aufgeführt ist. Beispielsweise
us-east-1legt der Wert den Endpunkt auf den Osten der AWS-Region USA (Nord-Virginia) fest. -
aws-globalgibt den globalen Endpunkt für Dienste an, die zusätzlich zu regionalen Endpunkten einen separaten globalen Endpunkt unterstützen, wie z. B. AWS -Security-Token-Service (AWS STS) und Amazon Simple Storage Service (Amazon S3).
-
Beispiel für die Einstellung dieses Werts in der config Datei:
[default] region = us-west-2
Linux/macOS Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:
export AWS_REGION=us-west-2
Windows-Beispiel für das Setzen von Umgebungsvariablen über die Befehlszeile:
setx AWS_REGION us-west-2
Die meisten SDKs verfügen über ein „Konfigurationsobjekt“, mit dem die Standardregion im Anwendungscode festgelegt werden kann. Einzelheiten finden Sie in Ihrem spezifischen AWS SDK-Entwicklerhandbuch.
Unterstützung von AWS SDKs und Tools
Die folgenden SDKs unterstützen die in diesem Thema beschriebenen Funktionen und Einstellungen. Alle teilweisen Ausnahmen werden vermerkt. Alle JVM-Systemeigenschaftseinstellungen werden von AWS SDK für Java and the AWS SDK für Kotlin only unterstützt.
| SDK | Unterstützt | Hinweise oder weitere Informationen |
|---|---|---|
| AWS CLI v2 | Ja | AWS CLI v2 verwendet einen beliebigen Wert in AWS_REGION vor jedem Wert in AWS_DEFAULT_REGION (beide Variablen werden überprüft). |
| AWS CLI v1 | Ja | AWS CLI v1 verwendet die AWS_DEFAULT_REGION für diesen Zweck benannte Umgebungsvariable. |
| SDK für C++ | Ja | |
| SDK für Go V2 (1.x) | Ja | |
| SDK für Go 1.x (V1) | Ja | Um die Einstellungen für gemeinsam genutzte config Dateien zu verwenden, müssen Sie das Laden aus der Konfigurationsdatei aktivieren; siehe Sitzungen. |
| SDK für Java 2.x | Ja | |
| SDK für Java 1.x | Ja | |
| SDK für 3.x JavaScript | Ja | |
| SDK für 2.x JavaScript | Ja | |
| SDK für Kotlin | Ja | |
| SDK für.NET 4.x | Ja | |
| SDK für.NET 3.x | Ja | |
| SDK für PHP 3.x | Ja | |
| SDK für Python (Boto3) | Ja | Dieses SDK verwendet die AWS_DEFAULT_REGION für diesen Zweck benannte Umgebungsvariable. |
| SDK für Ruby 3.x | Ja | |
| SDK für Rust | Ja | |
| SDK für Swift | Ja | |
| Tools für PowerShell V5 | Ja | |
| Tools für V4 PowerShell | Ja |
