Migrieren Sie Ihren Code auf SDK für JavaScript V3 - AWS SDK for JavaScript

Helfen Sie uns, dasAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation durch Feedback unter Verwendung derFeedbackLink oder erstellen Sie ein Problem oder ziehen Sie eine Anfrage anGitHubaus.

DieAWS SDK for JavaScriptReferenzhandbuch zur V3-API-Referenzbeschreibt ausführlich alle API-Operationen für dieAWS 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.

Migrieren Sie Ihren Code auf SDK für JavaScript V3

Es gibt eine Reihe von Migrationspfaden zum SDK für JavaScript Version 3 (V3). Um die Reduzierung des Kapazitätspotentials von V3 voll auszunutzen, empfehlen wir die Verwendung von Pfad 3.

Wichtig

AWS SDK for JavaScriptVersion 3 (v3) enthält auch modernisierte Schnittstellen für Clientkonfigurationen und Dienstprogramme, darunter Anmeldeinformationen, mehrteiliger Amazon S3 S3-Upload, DynamoDB-Dokument-Client, Kellner usw.). Was sich in v2 und den v3-Äquivalenten für jede Änderung geändert hat, finden Sie imMigrationsleitfaden zurAWS SDK for JavaScriptGitHub Repoaus.

Path 1

Führen Sie minimale Änderungen durch:

  • Installieren Sie nur das spezifischeAWSServicepakete, die Sie benötigen.

  • Erstellen und verwenden Sie V3-Dienstclients und ersetzen Sie die Verwendung globaler Konfigurationswerte wie Region durch Konfigurationswerte, die als Argumente an den Client übergeben werden.

    Anmerkung

    Sie können dieAWSRegion mit einer Umgebungsvariablen oder einer gemeinsam genutzten Konfigurationconfigfile. Weitere Informationen finden Sie unterEinrichten der Anmeldeinformationen in Node.jsaus.

Path 2

Folge Pfad 1 und entferne.promise, die in V3 nicht erforderlich sind.

Path 3

Folgen Sie Pfad 1 und verwenden Sie das async/await-Programmiermodell.

Wichtig

Für Informationen über signifikante Änderungen vonAWS SDK for JavaScriptv2 bis v3, sieheUpgraden von Notizen (2.x auf 3.x)auf GitHub:

In den folgenden Abschnitten werden diese Pfade ausführlich beschrieben und anhand von Beispielen beschrieben.

Beispiel für Pfad 1

Der folgende Code installiert dasAWSServicepaket für Amazon S3.

npm install @aws-sdk/client-s3

Der folgende Code lädt den Amazon S3 S3-Dienst.

import {S3} from '@aws-sdk/client-s3';
Anmerkung

Um diesen Ansatz verwenden zu können, müssen Sie das vollständige importierenAWSServicepakete,S3in diesem Fall und nicht nur die Servicekunden.

Der folgende Code erstellt ein Amazon S3-Serviceobjekt imus-west-2Region :

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

Der folgende Code erstellt und Amazon S3 S3-Bucket unter Verwendung einer Callback-Funktion unter Verwendung der folgenden Syntax von V2.

client.command(parameters)
import {S3} from '@aws-sdk/client-s3'; const client = new S3({region: 'us-west-2'}); const bucketParams = { Bucket : BUCKET_NAME }; function run(){ client.createBucket(bucketParams, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.Location); } }) }; run();

Beispiel für Pfad 2

Hier ist ein Funktionsaufruf in V2 mit einempromiseaus.

const data = await v2client.command(params).promise()

Hier ist die V3-Version.

const data = await v3client.command(params)

Beispiele für Pfad 3

Der folgende Befehl installiert dasAWSServicepaket für Amazon S3.

npm install @aws-sdk/client-s3;

Der folgende Code lädt nur den Amazon S3 S3-Client und reduziert den Overhead.

import {S3Client, CreateBucketCommand} from '@aws-sdk/client-s3';

Wenn Sie nur den Client eines Pakets installieren, müssen Sie auch die V3-Befehle importieren, die Sie verwenden möchten. In diesem Fall importiert der Code dieCreateBucketCommand, sodass Sie einen Amazon S3 S3-Bucket erstellen können. Sie können die verfügbaren Befehle in Ihrem Projekt durchsuchennode-modules/@aws-sdk/client-PACKAGE_NAME/commandsfolder.

Der folgende Code erstellt ein Amazon S3-Service-Client-Objekt imus-west-2Region :

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

Um importierte Befehle mit dem empfohlenen async/await-Muster aufzurufen, müssen Sie die gewünschten Befehle importieren und die folgende Syntax verwenden, um den Befehl auszuführen.

CLIENT.send(newXXXCommand)

Im folgenden Beispiel wird ein Amazon S3-Bucket unter Verwendung des async/await-Musters erstellt, wobei nur der Client des Amazon S3-Servicepakets verwendet wird, um den Overhead zu reduzieren.

import {S3Client, CreateBucketCommand} from '@aws-sdk/client-s3'; const client = new S3Client({region: 'us-west-2'}); const bucketParams = { Bucket : BUCKET_NAME }; (async function () { try{ const data = await client.send(new CreateBucketCommand(bucketParams)); console.log("Success", data); } catch (err) { console.log("Error", err); } })();

Weitere Beispiele finden Sie unter Beispiele für JavaScript Codebeispiele für.