O Guia de API referência da AWS SDK for JavaScript V3 descreve detalhadamente todas as API operações da AWS SDK for JavaScript
versão 3 (V3).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Sintaxe ES6/CommonJS de JavaScript
Os exemplos de código do AWS SDK for JavaScript são escritos em ECMAScript 6 (ES6). O ES6 apresenta nova sintaxe e novos recursos para tornar seu código mais moderno e legível, além de fazer mais.
O ES6 requer que você use o Node.js versão 13.x ou superior. Para baixar e instalar a versão mais recente do Node.js, consulte Downloads do Node.js. Entretanto, se você preferir, poderá converter qualquer um dos nossos exemplos em sintaxe CommonJS usando as seguintes diretrizes:
Remova "type" : "module"
do package.json
no ambiente do projeto.
Converta todas as instruções import
de ES6 em instruções require
de CommonJS. Por exemplo, converta:
import { CreateBucketCommand } from "@aws-sdk/client-s3";
import { s3 } from "./libs/s3Client.js";
Em seu equivalente de CommonJS:
const { CreateBucketCommand } = require("@aws-sdk/client-s3");
const { s3 } = require("./libs/s3Client.js");
Converta todas as instruções export
de ES6 em instruções module.exports
de CommonJS. Por exemplo, converta:
export {s3}
Em seu equivalente de CommonJS:
module.exports = {s3}
O exemplo a seguir demonstra o exemplo de código para criar um bucket do Amazon S3 em ES6 e CommonJS.
- ES6
libs/s3Client.js
// Create service client module using ES6 syntax.
import { S3Client } from "@aws-sdk/client-s3";
// Set the AWS region
const REGION = "eu-west-1"; //e.g. "us-east-1"
// Create Amazon S3 service object.
const s3 = new S3Client({ region: REGION });
// Export 's3' constant.
export {s3};
s3_createbucket.js
// Get service clients module and commands using ES6 syntax.
import { CreateBucketCommand } from "@aws-sdk/client-s3";
import { s3 } from "./libs/s3Client.js";
// Get service clients module and commands using CommonJS syntax.
// const { CreateBucketCommand } = require("@aws-sdk/client-s3");
// const { s3 } = require("./libs/s3Client.js");
// Set the bucket parameters
const bucketParams = { Bucket: "BUCKET_NAME" };
// Create the Amazon S3 bucket.
const run = async () => {
try {
const data = await s3.send(new CreateBucketCommand(bucketParams));
console.log("Success", data.Location);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
- CommonJS
libs/s3Client.js
// Create service client module using CommonJS syntax.
const { S3Client } = require("@aws-sdk/client-s3");
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Amazon S3 service object.
const s3 = new S3Client({ region: REGION });
// Export 's3' constant.
module.exports ={s3};
s3_createbucket.js
// Get service clients module and commands using CommonJS syntax.
const { CreateBucketCommand } = require("@aws-sdk/client-s3");
const { s3 } = require("./libs/s3Client.js");
// Set the bucket parameters
const bucketParams = { Bucket: "BUCKET_NAME" };
// Create the Amazon S3 bucket.
const run = async () => {
try {
const data = await s3.send(new CreateBucketCommand(bucketParams));
console.log("Success", data.Location);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();