Festlegen der AWS Region - AWS SDK for JavaScript
In einem Client-KlassenkonstruktorVerwenden des Global Configuration ObjectVerwenden einer UmgebungsvariablenVerwenden einer freigegebenen KonfigurationsdateiRangfolge zum Festlegen der Region

Wir haben die bevorstehende end-of-support für AWS SDK for JavaScript v2 angekündigt. Wir empfehlen Ihnen, zu AWS SDK for JavaScript v3 zu migrieren. Datumsangaben, zusätzliche Details und Informationen zur Migration finden Sie in der verlinkten Ankündigung.

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.

Festlegen der AWS Region

Eine Region ist ein benannter Satz von AWS Ressourcen im selben geografischen Gebiet. Ein Beispiel für eine Region ist us-east-1, die Region USA Ost (Nord-Virginia). Sie geben bei der Konfiguration des SDK für eine Region an, JavaScript sodass 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 Services in jeder Region finden Sie unter AWS Regionen und Endpunkte im 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

Ähnlich wie Sie in der freigegebenen Anmeldeinformationsdatei Anmeldeinformationen für die Verwendung durch das SDK speichern können, haben Sie die Möglichkeit, die Region und andere Konfigurationseinstellungen in einer freigegebenen Datei mit dem Namen config zu speichern, die von den SDKs verwendet wird. Wenn die AWS_SDK_LOAD_CONFIG Umgebungsvariable auf einen wahrheitsgemäßen Wert festgelegt 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 freigegebener Konfigurations- und Anmeldeinformationsdateien finden Sie unter Laden der Anmeldeinformationen in Node.js aus der freigegebenen Anmeldeinformationsdatei oder Konfigurations- und Anmeldeinformationsdateien 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 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 Umgebungsvariable AWS_SDK_LOAD_CONFIG als wahrer Wert definiert wird und die freigegebene Anmeldeinformationsdatei (~/.aws/credentials oder der durch AWS_SHARED_CREDENTIALS_FILE angegebene Pfad) eine Region für das konfigurierte Profil enthält, wird diese Region verwendet. Ist dies nicht der Fall, dann...

  • Wenn die Umgebungsvariable AWS_SDK_LOAD_CONFIG als wahrer Wert definiert wird und die Config-Datei (~/.aws/config oder der durch AWS_CONFIG_FILE angegebene Pfad) eine Region für das konfigurierte Profil enthält, wird diese Region verwendet.