AWS SDK for JavaScript V3 API 참조 안내서는 AWS SDK for JavaScript 버전 3(V3)의 모든 API 작업을 자세히 설명합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

버전 3으로 마이그레이션

이 섹션에서는 버전 2에서 버전 3으로 마이그레이션하는 방법을 설명합니다. AWS SDK for JavaScript

코드를 V3용 JavaScript SDK로 마이그레이션하세요.

AWS SDK for JavaScript 버전 3 (v3) 에는 자격 증명, Amazon S3 멀티파트 업로드, DynamoDB 문서 클라이언트, 웨이터 등을 포함하는 클라이언트 구성 및 유틸리티를 위한 현대화된 인터페이스가 함께 제공됩니다. 리포지토리의 마이그레이션 가이드에서 각 변경 사항에 대한 v2 및 v3의 해당 변경 내용을 확인할 수 있습니다. AWS SDK for JavaScript GitHub

AWS SDK for JavaScript v3를 최대한 활용하려면 아래에 설명된 codemod 스크립트를 사용하는 것이 좋습니다.

codemod를 사용하여 기존 v2 코드를 마이그레이션하십시오.

의 codemod 스크립트 컬렉션은 기존 AWS SDK for JavaScript (v2) 애플리케이션을 v3 API를 사용하도록 마이그레이션하는 aws-sdk-js-codemod데 도움이 됩니다. 다음과 같이 변환을 실행할 수 있습니다.

$ npx aws-sdk-js-codemod -t v2-to-v3 PATH...

예를 들어 v2에서 Amazon DynamoDB 클라이언트를 생성하고 listTables 작업을 직접적으로 호출하는 다음 코드가 있다고 가정해 보겠습니다.

// example.ts
import AWS from "aws-sdk";

const region = "us-west-2";
const client = new AWS.DynamoDB({ region });
client.listTables({}, (err, data) => {
  if (err) console.log(err, err.stack);
  else console.log(data);
});

다음과 같이 example.ts에서 v2-to-v3 변환을 실행할 수 있습니다.

$ npx aws-sdk-js-codemod -t v2-to-v3 example.ts

이 변환은 DynamoDB import를 v3로 변환하고 v3 클라이언트를 생성하며 다음과 같이 listTables 작업을 직접적으로 호출합니다.

// example.ts
import { DynamoDB } from "@aws-sdk/client-dynamodb";

const region = "us-west-2";
const client = new DynamoDB({ region });
client.listTables({}, (err, data) => {
  if (err) console.log(err, err.stack);
  else console.log(data);
});

일반적인 사용 사례에 대한 변환을 구현했습니다. 코드가 올바르게 변환되지 않는 경우 입력 코드 예와 관찰/예상된 출력 코드가 포함된 bug report 또는 feature request를 작성하세요. 특정 사용 사례가 existing issue에서 이미 보고된 경우 공감을 표시하여 지지를 보여주세요.