Wir haben das Kommende end-of-support für AWS SDK for JavaScript v2 angekündigt. Wir empfehlen Ihnen, auf AWS SDK for JavaScript Version 3 zu migrieren. Termine, weitere 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.

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 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

Ä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 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:

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 oder Konfigurations- und Anmeldeinformationsdateien im AWS Command Line Interface Benutzerhandbuch.

Rangfolge zum Festlegen der Region

Die Rangfolge zum Festlegen der Region ist wie folgt: