全部文档
当前文档
最近更新时间：2025-04-25 15:41:52
本文介绍如何在Node.js环境中快速使用KS3服务，包括查看存储空间（Bucket） 列表、上传文件（Object）等。
前提条件：已完成初始化，具体操作，请参见初始化。
创建存储空间
以下代码用于创建存储空间。
client.bucket.put({
Bucket: '<bucketName>', // 必填，存储空间名称
ACL: 'private', // 非必填，存储空间访问权限，有效值：private、public-read、public-read-write
Type: 'NORMAL', //非必填，存储类型，有效值：NORMAL、IA、ARCHIVE
Region: '', //非必填，存储region
ProjectId: '', //非必填，项目组id，未指派项目信息的存储空间将被分配到默认项目组中
VisitType: 'NORMAL' //非必填，存储空间访问类型，有效值：NORMAL、FREQUENTLIST,
headers:{
'x-kss-server-side-encryption': 'ASE256' //非必填，如果设置此头，表示创建桶时开启置桶的服务端加密，有效值：AES256
}
}, function (rerr, data, response, body) {
console.log(data) // 如果成功返回200，已存在返回409
})
bucketName必须符合命名要求，详情请参见空间管理-基本操作。
列举存储空间
以下代码用于查看存储空间列表。
client.service.listBucket(function(rerr, data, response, body) {
console.log(data)
})获取文件列表
以下代码用于获取指定存储空间下的文件列表。
client.bucket.get({
Bucket: '<bucketName>',
Delimiter: '/',
Prefix: 'img',
MaxKeys: 1000 // 默认1000
}, function (rerr, data, response, body) {
console.log(data)
})上传文件
以下代码用于上传单个文件。
client.object.put({
Bucket: '<bucketName>',
Key: '<objectKey>',
FilePath: '<filePath>'
}, function (rerr, data, response, body) {
console.log(data)
})下载文件
以下代码用于下载文件到本地。
client.object.get({
Bucket: '<bucketName>',
Key: '<objectKey>'
}, function (rerr, data, response, body) {
console.log(data)
})删除文件
以下代码用于删除服务端指定文件。
client.object.del({
Bucket: '<bucketName>',
Key: '<objectKey>'
}, function (rerr, data, response, body) {
console.log(data)
})纯净模式