Festlegen desAWSRegion - AWS SDK for JavaScript

Hilf uns, das zu verbessernAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation, indem Sie Feedback mithilfe derFeedbackverlinken, oder erstellen Sie ein Issue oder Pull Request aufGitHubaus.

DieAWS SDK for JavaScriptReferenzhandbuch zur V3-APIbeschreibt ausführlich alle API-Operationen für denAWS SDK for JavaScriptVersion 3 (V3).

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 desAWSRegion

Importieren in &S3;AWSRegion ist ein benannter Satz vonAWSRessourcen im gleichen geografischen Gebiet. Ein Beispiel für eine Region istus-east-1, das ist die Region US East (N. Virginia). Sie geben eine Region an, wenn Sie einen Service-Client im SDK für erstellen JavaScript Damit das SDK auf den Service in dieser Region zugreift. Einige -Services werden nur in bestimmten Regionen angeboten.

Das SDK für JavaScript wählt eine Region nicht standardmäßig aus. Sie können jedoch dieAWSRegion mit einer Umgebungsvariablen oder einer gemeinsam genutzten Konfigurationconfigfile.

In einem Client-Klassenkonstruktor

Wenn Sie ein Serviceobjekt instanziieren, können Sie dasAWSDie Region für diese Ressource als Teil des Client-Klassenkonstruktors, wie hier gezeigt.

const s3Client = new S3.S3Client({region: 'us-west-2'});

Verwenden einer Umgebungsvariablen

Sie können die Region mithilfe der Umgebungsvariablen AWS_REGION festlegen. Wenn Sie diese Variable definieren, wird das SDK für JavaScript liest es und benutzt es.

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, dieAWSRegion und andere Konfigurationseinstellungen in einer freigegebenen Datei mit dem Namenconfigdamit das SDK verwendet werden kann. Wenn das SymbolAWS_SDK_LOAD_CONFIGDie Umgebungsvariable ist auf einen wahrer Wert festgelegt, das SDK für JavaScript sucht automatisch nach einemconfig-Datei, wenn es geladen wird. Wo Sie die config-Datei speichern, hängt von Ihrem Betriebssystem ab:

  • Benutzer von Linux, macOS oder Unix -~/.aws/config

  • Windows-Nutzer -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-west-2 output=json

Weitere Informationen zur Verwendung von Sharedconfigund Anmeldeinformationen finden Sie unterLaden der Anmeldeinformationen in Node.js aus der Datei für gemeinsam genutzte AnmeldeinformationenoderKonfigurationsdateien und AnmeldeinformationsdateienimAWS Command Line Interface-Benutzerhandbuchaus.

Rangfolge für das Festlegen der Region

Für die Einstellung der Region gilt die folgende Rangfolge:

  1. Wenn eine Region an einen Client-Klassenkonstruktor übergeben wird, wird diese Region verwendet.

  2. Wenn eine Region in der Umgebungsvariablen festgelegt ist, wird diese Region verwendet.

  3. Andernfalls wird die in der freigegebenen Konfigurationsdatei definierte Region verwendet.