最近更新时间: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)
})
纯净模式