Die AWS SDK für JavaScript Version 2 ist erreicht end-of-support. Wir empfehlen Ihnen, auf [AWS SDK für JavaScript Version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) zu migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in dieser [Ankündigung](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
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.
# Einstellung der AWS Region
Eine Region ist eine benannte Gruppe von AWS Ressourcen in demselben geografischen Gebiet. Ein Beispiel für eine Region ist `us-east-1` die Region USA Ost (Nord-Virginia). Sie geben eine Region an, wenn Sie das SDK JavaScript so konfigurieren, dass das SDK auf die Ressourcen in dieser Region zugreift. Einige -Services werden nur in bestimmten Regionen angeboten.
Das SDK für wählt standardmäßig JavaScript keine Region aus. Sie können jedoch die Region mithilfe einer Umgebungsvariablen, einer freigegebenen `config`-Datei oder dem globalen Konfigurationsobjekt definieren.
## In einem Client-Klassenkonstruktor
Wenn Sie ein Dienstobjekt instanziieren, können Sie die Region für die Ressource als Teil des Client-Klassenkonstruktors angeben, wie hier dargestellt.
```
var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-east-1'});
```
## Verwenden des Global Configuration Object
Um die Region in Ihrem JavaScript Code festzulegen, aktualisieren Sie das `AWS.Config` globale Konfigurationsobjekt wie hier gezeigt.
```
AWS.config.update({region: 'us-east-1'});
```
Weitere Informationen zu aktuellen Regionen und verfügbaren Diensten in den einzelnen Regionen finden Sie unter [AWS Regionen und Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html) in der *Allgemeine AWS-Referenz*.
## Verwenden einer Umgebungsvariablen
Sie können die Region mithilfe der Umgebungsvariablen `AWS_REGION` festlegen. Wenn Sie diese Variable definieren, JavaScript liest das SDK für sie und verwendet sie.
## Verwenden einer freigegebenen Konfigurationsdatei
So wie Sie mit der Datei mit gemeinsamen Anmeldeinformationen Anmeldeinformationen für die Verwendung durch das SDK speichern können, können Sie Ihre Region und andere Konfigurationseinstellungen in einer gemeinsam genutzten Datei mit dem Namen speichern`config`, der von verwendet wird SDKs. Wenn die `AWS_SDK_LOAD_CONFIG` Umgebungsvariable auf einen beliebigen Wert gesetzt wurde, sucht das SDK für beim Laden JavaScript automatisch nach einer `config` Datei. Wo Sie die ` config`-Datei speichern, hängt von Ihrem Betriebssystem ab:
+ Benutzer von Linux, macOS oder Unix: `~/.aws/config`
+ Benutzer von Windows: `C:\Users\USER_NAME\.aws\config`
Wenn Sie noch keine freigegebene `config`-Datei haben, können Sie diese in dem angegebenen Verzeichnis erstellen. Im folgenden Beispiel werden sowohl die Region als auch das Ausgabeformat über die `config`-Datei definiert.
```
[default]
region=us-east-1
output=json
```
Weitere Informationen zur Verwendung gemeinsam genutzter Konfigurations- und Anmeldeinformationsdateien finden Sie unter [Laden der Anmeldeinformationen in Node.js aus der freigegebenen Anmeldeinformationsdatei](loading-node-credentials-shared.md) oder [Konfigurations- und Anmeldeinformationsdateien](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) im *AWS Command Line Interface Benutzerhandbuch*.
## Rangfolge zum Festlegen der Region
Die Rangfolge zum Festlegen der Region ist wie folgt:
+ Wenn eine Region an einen Client-Klassenkonstruktor übergeben wird, wird diese Region verwendet. Ist dies nicht der Fall, dann...
+ Wenn eine Region für das globale Konfigurationsobjekt festgelegt ist, wird diese Region verwendet. Ist dies nicht der Fall, dann...
+ Wenn die Umgebungsvariable `AWS_REGION` ein [wahrer](https://developer.mozilla.org/en-US/docs/Glossary/Truthy) Wert ist, wird diese Region verwendet. Ist dies nicht der Fall, dann...
+ Wenn die Umgebungsvariable `AMAZON_REGION` ein wahrer Wert ist, wird diese Region verwendet. Ist dies nicht der Fall, dann...
+ Wenn die `AWS_SDK_LOAD_CONFIG` Umgebungsvariable auf einen beliebigen Wert gesetzt ist und die Datei mit gemeinsamen Anmeldeinformationen (`~/.aws/credentials`oder der durch angegebene Pfad`AWS_SHARED_CREDENTIALS_FILE`) eine Region für das konfigurierte Profil enthält, wird diese Region verwendet. Ist dies nicht der Fall, dann...
+ Wenn die `AWS_SDK_LOAD_CONFIG` Umgebungsvariable auf einen beliebigen Wert gesetzt ist und die Konfigurationsdatei (`~/.aws/config`oder der durch angegebene Pfad`AWS_CONFIG_FILE`) eine Region für das konfigurierte Profil enthält, wird diese Region verwendet.