当前位置：首页 > news >正文

AWS S3 JavaScript SDK(v3)常用操作

news 2025/8/11 17:30:47

安装 aws s3 sdk

npm install @aws-sdk/client-s3

配置

创建 ~/.aws/credentials 文件，添加以下配置项：

[default]
aws_access_key_id=<...>
aws_secret_access_key=<...>
region=<...>

S3 SDK常用桶操作

获取桶列表

import {S3Client,Bucket,paginateListBuckets,
} from "@aws-sdk/client-s3";async function listBuckets() {const client = new S3Client({});try {const buckets: Bucket[] = [];for await (const page of paginateListBuckets({ client }, {})) {if (page.Buckets) {buckets.push(...page.Buckets);}}console.log("Buckets: ", buckets);} catch (error) {console.error(error);}
}

创建桶

import {S3Client,Bucket,CreateBucketCommand,waitUntilBucketExists,
} from "@aws-sdk/client-s3";async function createBucket(bucket: string) {const client = new S3Client({});try {const { Location } = await client.send(new CreateBucketCommand({Bucket: bucket,}));await waitUntilBucketExists({ client, maxWaitTime: 1000 }, { Bucket: bucket });console.log(`Bucket created with location ${Location}`);} catch (error) {console.error(error);}
}

删除桶

import {S3Client,Bucket,DeleteBucketCommand,waitUntilBucketExists,
} from "@aws-sdk/client-s3";async function deleteBucket(bucket: string) {const client = new S3Client({});try {await client.send(new DeleteBucketCommand({Bucket: bucket,}));console.log("Bucket was deleted.");} catch (error) {console.error(error);}
}

S3 SDK常用对象操作

获取对象列表

import {S3Client,Bucket,paginateListObjectsV2,
} from "@aws-sdk/client-s3";async function listObjects(bucket: string) {const client = new S3Client({});try {const objects = [];const paginator = paginateListObjectsV2({ client, pageSize: 2 }, { Bucket: bucket });for await (const page of paginator) {if (page.Contents) {objects.push(page.Contents.map((o) => o.Key));}}console.log("Objects: ", objects);} catch (error) {console.error(error);}
}

获取对象

import {S3Client,Bucket,GetObjectCommand,
} from "@aws-sdk/client-s3";async function getObject(bucket: string, key: string) {const client = new S3Client({});try {const response = await client.send(new GetObjectCommand({Bucket: bucket,Key: key,}));if (response.Body) {console.log(await response.Body.transformToString());}} catch (error) {console.error(error);}
}

上传对象

import {S3Client,Bucket,PutObjectCommand,
} from "@aws-sdk/client-s3";
import { readFile } from "node:fs/promises";async function putObject(bucket: string, key: string, filePath: string) {const client = new S3Client({});try {const response = await client.send(new PutObjectCommand({Bucket: bucket,Key: key,Body: await readFile(filePath),}));console.log(response);} catch (error) {console.error(error);}
}

删除对象

import {S3Client,Bucket,DeleteObjectCommand,
} from "@aws-sdk/client-s3";async function deleteObject(bucket: string, key: string) {const client = new S3Client({});try {const response = await client.send(new DeleteObjectCommand({Bucket: bucket,Key: key,}));console.log(response);} catch (error) {console.error(error);}
}