Bucket的相關命令

ossutil提供了建立、刪除、列舉Bucket、以及為Bucket設定acl的功能，關於Bucket更多的管理功能暫時不支援，如需要請使用osscmd。

在使用這些命令前，請先使用config命令配置訪問AK。

  • 建立Bucket
    ossutil mb oss://bucket [--acl=acl] [--storage-class sc] [-c file]
    其中acl如果不指定，則預設為private許可權，如果成功建立，ossutil會列印消耗時間並退出，否則會輸出錯誤資訊。可以通過--storage-class選項指定儲存方式。

    關於建立Bucket的幫助資訊，請使用ossutil help mb命令查看。 

    $./ossutil mb oss://test
0.220478(s) elapsed
  • 刪除Bucket

    關於刪除Bucket的幫助資訊，請使用ossutil help rm命令查看。注意：

    • 刪除bucket必須設定-b選項；
    • 被刪除的bucket可能被其他用戶重新建立，從而不再屬於您；
    • bucket中的數據一旦被刪除則無法恢複。

    （1）如果您的Bucket中沒有數據

    ossutil rm oss://bucket -b
    $./ossutil rm oss://test -b
Do you really mean to remove the Bucket: test(y or N)? y
0.220478(s) elapsed

    （2) 如果您的Bucket中有object或multipart等數據，需要先刪除所有數據再刪除Bucket，可以使用以下命令來一併刪除所有數據和您的Bucket 

    ossutil rm oss://bucket -bar

    關於刪除Bucket的幫助資訊，請使用ossutil help rm命令查看。

  • 列舉Buckets

    ./ossutil ls或 ./ossutil ls oss://

    可以使用-s選項來顯示精簡格式，更多幫助見: ossutil help ls 

    $./ossutil ls
CreationTime                                 Region    StorageClass    BucketName
2016-10-21 16:18:37 +0800 CST       oss-cn-hangzhou         Archive    oss://go-sdk-test-bucket-xyz-for-object
2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://ossutil-test
2016-07-18 17:54:49 +0800 CST       oss-cn-hangzhou        Standard    oss://ossutilconfig
2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://ossutilupdate
2016-11-14 13:08:36 +0800 CST       oss-cn-hangzhou              IA    oss://yyyyy
2016-08-25 09:06:10 +0800 CST       oss-cn-hangzhou         Archive    oss://ztzt
2016-11-21 21:18:39 +0800 CST       oss-cn-hangzhou         Archive    oss://ztztzt
Bucket Number is: 7
0.252174(s) elapsed
  • 列舉Bucket中的檔案

    ossutil可以列舉Bucket中的Object和UploadID，預設情況下顯示Object，使用-m選項來顯示UploadID，使用-a選項同時顯示Object和UploadID。

    • 列舉Object
      ./ossutil ls oss://bucket
      $./ossutil ls oss://ossutil-test
LastModifiedTime                    Size(B)  StorageClass   ETAG                                    ObjectName
2016-12-01 15:06:37 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://ossutil-test/a1
2016-12-01 15:06:42 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://ossutil-test/a2
2016-12-01 15:06:45 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://ossutil-test/a3
Object Number is: 3
0.007379(s) elapsed
    • 列舉Object和Multipart
      ./ossutil ls oss://bucket -a
      $ ossutil ls oss://bucket1 -a
LastModifiedTime                    Size(B)  StorageClass   ETAG                                    ObjectName
2015-06-05 14:06:29 +0000 CST        201933      Standard   7E2F4A7F1AC9D2F0996E8332D5EA5B41        oss://bucket1/dir1/obj11
2015-06-05 14:36:21 +0000 CST        201933      Standard   6185CA2E8EB8510A61B3A845EAFE4174        oss://bucket1/obj1
2016-04-08 14:50:47 +0000 CST       6476984      Standard   4F16FDAE7AC404CEC8B727FCC67779D6        oss://bucket1/sample.txt
Object Number is: 3
InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://bucket1/obj1
2017-01-13 03:43:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://bucket1/obj1
2017-01-13 03:45:25 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://bucket1/obj2
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://bucket1/tobj
UploadId Number is: 4
0.191289(s) elapsed

      可以使用-s選項顯示精簡模式。可以使用-d選項顯示首層目錄下的內容。

      $ ossutil ls oss://bucket1 -d
oss://bucket1/obj1
oss://bucket1/sample.txt
oss://bucket1/dir1/
Object and Directory Number is: 3
UploadID                            ObjectName
15754AF7980C4DFB8193F190837520BB    oss://bucket1/obj1
2A1F9B4A95E341BD9285CC42BB950EE0    oss://bucket1/obj1
3998971ACAF94AD9AC48EAC1988BE863    oss://bucket1/obj2
A20157A7B2FEC4670626DAE0F4C0073C    oss://bucket1/tobj
UploadId Number is: 4
0.119884(s) elapsed
  • 為Bucket設定acl

    建立Bucket時，Bucket預設的acl為private，可以通過set-acl命令來修改Bucket的acl。在設定Bucket的acl許可權時，需要設定-b選項。

    將bucket1設定為private許可權：

    ./ossutil set-acl oss://bucket1 private -b

    關於設定acl的更多資訊請使用help set set-acl來查看。