Legen Sie die AWS Region fest - AWS SDK for JavaScript

Das AWS SDK for JavaScript APIV3-Referenzhandbuch beschreibt detailliert alle API Funktionen für die AWS SDK for JavaScript Version 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.

Legen Sie die AWS Region fest

Eine AWS 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 einen Service-Client in der Form SDK erstellen, JavaScript sodass der SDK auf den Service 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 die AWS Region jedoch mithilfe einer Umgebungsvariablen oder einer gemeinsam genutzten config Konfigurationsdatei festlegen.

In einem Client-Klassenkonstruktor

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

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

Verwenden Sie eine Umgebungsvariable

Sie können die Region mithilfe der Umgebungsvariablen AWS_REGION festlegen. Wenn Sie diese Variable definieren, JavaScript liest das SDK for sie und verwendet sie.

Verwenden Sie eine gemeinsam genutzte Konfigurationsdatei

Ähnlich wie Sie mit der Datei mit gemeinsam genutzten Anmeldeinformationen Anmeldeinformationen für die speichern könnenSDK, können Sie Ihre AWS Region und andere Konfigurationseinstellungen in einer gemeinsam genutzten Datei speichern, die config nach der SDK zu verwendenden benannt ist. Wenn die AWS_SDK_LOAD_CONFIG Umgebungsvariable auf einen wahrheitsgemäßen Wert gesetzt ist, sucht SDK for beim Laden JavaScript automatisch nach einer config Datei. Wo Sie die config-Datei speichern, hängt von Ihrem Betriebssystem ab:

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

  • Windows-Benutzer - 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 credentials Dateien config und gemeinsam genutzten Dateien finden Sie unter Dateien mit gemeinsam genutzten Konfigurationen und Anmeldeinformationen im AWS SDKsReferenzhandbuch zu Tools.

Reihenfolge der Festlegung der Region

Im Folgenden finden Sie die Rangfolge für die Einstellung der Region:

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

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

  3. Andernfalls wird die in der gemeinsam genutzten Konfigurationsdatei definierte Region verwendet.