Related commands for Bucket

Ossutil allows you to create, delete, and list buckets, and set the ACL for a bucket. Other management functions related to the bucket are not supported currently. If you want to use these functions, see osscmd.

Before running these commands, run the config command to configure the AccessKey pair.

  • Create a bucket
    ossutil mb oss://bucket [--acl=acl] [--storage-class sc] [-c file]
    If the ACL is not specified, the bucket has the private permission by default. After a bucket is created, ossutil prints the consumed time and exits. Otherwise, ossutil outputs error information. You can use the --storage-class option to specify the storage mode.

    Run ossutil help mb to view help information about creating a bucket.

    $./ossutil mb oss://test
    0.220478(s) elapsed
  • Delete a bucket

    Run ossutil help rm to view help information about deleting a bucket.

    • The -b option must be specified for deleting a bucket.
    • The deleted bucket may have been re-created by another user and does not belong to you anymore.
    • Once deleted, data in the bucket cannot be recovered.
    • If you bucket does not contain any data:
      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
    • If your bucket contains the object, multipart, or other data, delete all data before deleting the bucket. You can run the following command to delete all data and your bucket:
      ossutil rm oss://bucket -bar

      Run ossutil help rm to view help information about deleting a bucket.

  • List buckets

    ./ossutil ls or  ./ossutil ls oss://

    You can use the -s option to display the short format. Run ossutil help ls to view more help information. 

    $./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
  • List files in a bucket

    Ossutil can list objects and UploadIDs in a bucket. The objects are displayed by default. You can use the -m option to display UploadIDs and use the -a option to display the objects and UploadIDs simultaneously.

    • List objects
      ./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
    • List objects and multiparts
      ./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

      You can use the -s option to display the short format.

      You can use the -d option to display content in the level 1 directory.

      $ ossutil ls oss://bucket1 -d
      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
  • Set the ACL for a bucket

    When a bucket is created, the default ACL for the bucket is private. You can run the set-acl command to modify the ACL for a bucket. You must specify the-b option when setting the ACL for a bucket.

    Grant the private permission for bucket1:

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

    Run the help set set-acl command to view more information about  setting the ACL.