全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

管理Bucket

更新时间:2017-06-12 17:53:38

存储空间(Bucket)是OSS上的命名空间,也是计费、权限控制、日志记录等高级功能的管理实体。

查看所有Bucket

使用listBuckets接口列出当前用户下的所有Bucket,用户还可以指定prefix参数,列出Bucket名字为特定前缀的所有Bucket:

  1. var co = require('co');
  2. var OSS = require('ali-oss');
  3. var client = new OSS({
  4. region: '<Your region>',
  5. accessKeyId: '<Your AccessKeyId>',
  6. accessKeySecret: '<Your AccessKeySecret>'
  7. });
  8. co(function* () {
  9. var result = yield client.listBuckets();
  10. console.log(result);
  11. var result = yield client.listBuckets({
  12. prefix: 'prefix'
  13. });
  14. console.log(result);
  15. }).catch(function (err) {
  16. console.log(err);
  17. });

创建Bucket

使用putBucket接口创建一个Bucket,用户需要指定Bucket的名字:

  1. var co = require('co');
  2. var OSS = require('ali-oss');
  3. var client = new OSS({
  4. region: '<Your region>',
  5. accessKeyId: '<Your AccessKeyId>',
  6. accessKeySecret: '<Your AccessKeySecret>'
  7. });
  8. co(function* () {
  9. var result = yield client.putBucket('bucket name');
  10. console.log(result);
  11. }).catch(function (err) {
  12. console.log(err);
  13. });

注意:

  • Bucket的命名规范请查看OSS 基本概念
  • 由于存储空间的名字是全局唯一的,所以必须保证您的Bucket名字不与别人的重复。

删除Bucket

使用deleteBucket接口删除一个Bucket,用户需要指定Bucket的名字:

  1. var co = require('co');
  2. var OSS = require('ali-oss');
  3. var client = new OSS({
  4. region: '<Your region>',
  5. accessKeyId: '<Your AccessKeyId>',
  6. accessKeySecret: '<Your AccessKeySecret>'
  7. });
  8. co(function* () {
  9. var result = yield client.deleteBucket('bucket name');
  10. console.log(result);
  11. }).catch(function (err) {
  12. console.log(err);
  13. });

注意:

  • 如果该Bucket下还有文件存在,则需要先删除所有文件才能删除Bucket。
  • 如果该Bucket下还有未完成的上传请求,则需要通过listUploadsabortMultipartUpload先取消请求才能删除Bucket。

Bucket访问权限

用户可以设置Bucket的访问权限,允许或者禁止匿名用户对其内容进行读写。更多关于访问权限的内容请参考访问权限

获取Bucket的访问权限(ACL)

通过getBucketACL查看Bucket的ACL:

  1. var co = require('co');
  2. var OSS = require('ali-oss');
  3. var client = new OSS({
  4. region: '<Your region>',
  5. accessKeyId: '<Your AccessKeyId>',
  6. accessKeySecret: '<Your AccessKeySecret>'
  7. });
  8. co(function* () {
  9. var result = yield client.getBucketACL('bucket name');
  10. console.log(result);
  11. }).catch(function (err) {
  12. console.log(err);
  13. });

设置Bucket的访问权限(ACL)

通过putBucketACL设置Bucket的ACL:

  1. var co = require('co');
  2. var OSS = require('ali-oss');
  3. var client = new OSS({
  4. region: '<Your region>',
  5. accessKeyId: '<Your AccessKeyId>',
  6. accessKeySecret: '<Your AccessKeySecret>'
  7. });
  8. co(function* () {
  9. var result = yield client.putBucketACL('bucket name', 'region', 'public-read');
  10. console.log(result);
  11. }).catch(function (err) {
  12. console.log(err);
  13. });
本文导读目录