帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

JavaScript SDK

QingStor JavaScript SDK 已在 GitHub 开源,下文为简要使用文档。更多详细信息请参见 https://github.com/yunify/qingstor-sdk-js

安装

使用 NPM 安装:

> npm install qingstor-sdk

快速开始

使用 SDK 之前请先在 青云控制台 申请 access key 。

初始化服务

发起请求前首先建立需要初始化服务:

var QingStor = require('qingstor-sdk').QingStor;
var config = require('qingstor-sdk').Config('ACCESS_KEY_ID', 'SECRET_ACCESS_KEY');
var service = new QingStor(config);

上面代码初始化了一个 QingStor Service

获取账户下的 Bucket 列表

service.listBuckets({'location': 'pek3a'}, function(err, data){
  console.log(data);
});

创建 Bucket

初始化并创建 Bucket, 需要指定 Bucket 名称和所在 Zone:

var test_bucket = test_service.Bucket('test-bucket', 'pek3a');
test_bucket.put(function(err, data){
  console.log(data);
})

获取 Bucket 中存储的 Object 列表

test_bucket.listObjects({}, function (err, data) {
  console.log(data);
});

创建一个 Object

上传一个文件:

test_bucket.putObject('test_file', {
  'body': fs.readFileSync('/tmp/test_file'),
}, function (err, data) {
  console.log(data);
});

删除一个 Object

test_bucket.deleteObject('test_object', function (err, data) {
  console.log(data);
});

设置 Bucket ACL

test_bucket.putACL({
  'acl': [{
    'grantee': {
      'type': 'user',
      'id':   'usr-xxxxxxxx',
    },
    'permission': 'FULL_CONTROL',
  }],
}, function (err, data) {
  console.log(data);
});