介绍
==============
此模块为又拍云SDK的Node.js版本,使用Promise机制。
安装
npm install node-upyun-sdk
使用
var upyun = require("node-upyun-sdk");
var instance = upyun("bucketname", "username", "password");
下面的所有接口返回的都是一个promise,可以通过下面的方式来获取返回值和捕获错误:
instance.getUsage("/").then(function(data){
console.log(data);
}).catch(function(error){
console.log(error);
})
getUsage(path)
- path string 目录名
获取目录的空间占用信息
instance.getUsage("/"); //获取根目录的空间使用情况
instance.getUsage("/foo/bar"); //获取/foo/bar目录的空间使用情况
upload(savePath, filePath, headers)
- savePath string 又拍云上存放的目录
- filePath string 本地要上传的目录
- headers object|string 附带的headers
文件或者文件夹上传
instance.upload("/aaa/", "img/c.jpg"); //将c.jpg文件上传到/aaa/下,保存的文件名为c.jpg
instance.upload("/aaa/a.jpg", "img/c.jpg"); //下c.jpg文件上传到/aaa/下,重新设置文件名为a.jpg
instance.upload("/aaa", "img/"); //将img/下的所有文件上传到/aaa目录下
instance.upload("/aaa/a.jpg", "img/c.jpg", "welefen"); //设置文件的Content-Secret上传
instance.upload("/aaa/a.jpg", "img/c.jpg", {
"x-gmkerl-type": "fix_width",
"x-gmkerl-value": 150
}); //设置图片处理信息
download(soucePath, savePath)
- sourcePath string 又拍云上的目录
- savePath string 存储的目录
文件或者文件夹下载
instance.download("/aaa", "img/"); //将/aaa目录下的文件下载到img目录下,包含子目录
instance.download("/aaa/a.jpg", "img/"); //将a.jpg文件下载到img目录下
instacen.download("/aaa/a.jpg", "img/c.jpg"); //将a.jpg文件下载到img目录并重命名为c.jpg
rm(path, force)
- path string 要删除的文件夹或者文件
- force boolean 是否强制删除,强制后会递归删除目录下所有的文件
删除文件或者文件夹
instance.rm("/aaa"); //删除/aaa目录,/aaa目录下必须为空
instance.rm("/aaa", true); //删除/aaa目录,如果/aaa下有子目录或者文件,先删除这些子目录和文件
instance.rm("/aaa/a.jpg"); //删除a.jpg文件
mkDir(path)
- path string 要创建的目录
创建目录
instance.mkDir("/aaa/bbb"); //递归的创建/aaa/bbb目录
readDir(path, recursive)
- path string 要读取的文件夹
- recursive boolean 是否是递归方式,递归方式数据里会有children字段信息
获取文件夹下的文件和子目录信息
instance.readDir("/aaa"); //获取/aaa目录下的文件和子目录
instance.readDir("/aaa", true); //获取/aaa目录下的文件和子目录,包含子目录详细信息
getInfo(path)
- path string 要获取信息的path
获取文件或者文件夹的信息
instance.getInfo("/aaa"); //获取/aaa文件夹的信息
instance.getInfo("/aaa/a.jpg"); //获取a.jpg文件的信息