Ossutil では、バケットを作成、一覧表示、削除、またはバケットの ACL の設定を行うことができます。 他のバケット管理機能は現在サポートされていません。 前述のバケットの機能を使用するには、「osscmd」をご参照ください。

これらのコマンドを実行する前に、config コマンドを実行して AccessKey ペアを設定します。

  • バケットの作成
    ossutil mb oss://bucket [--acl=acl] [--storage-class sc] [-c file]
    ACL が指定されていない場合、バケットにはデフォルトで非公開の権限を持ちます。 バケットが作成されると、ossutil は消費された時間を表示して終了します。 それ以外の場合、ossutil はエラー情報を出力します。 --storage-class オプションを使用してストレージモードを指定することができます。

    ossutil help mb を実行し、バケットの作成に関するヘルプ情報を表示します。

    $./ossutil mb oss://test
    0.220478(s) elapsed
  • バケットの削除

    バケットを削除する前に、次の点に注意してください。

    • バケットを削除するには、-b オプションを指定する必要があります。
    • 削除されたバケットはユーザーのものではなくなり、他のユーザーによって再作成される可能性があります。
    • 一度削除すると、バケット内のデータは復元できません。
    • バケットにデータが保存されていない場合、次のコマンドを実行してバケットを削除します。
      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
    • バケットにオブジェクトまたはマルチパーツデータが含まれている場合は、バケットを削除する前にすべてのデータを削除します。 次のコマンドを実行し、すべてのデータと自身のバケットを削除できます。
      ossutil rm oss://bucket -bar

      ossutil help mb を実行し、バケットの作成に関するヘルプ情報を表示させます。

  • バケットの一覧表示

    ./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
  • バケット内のファイルの一覧表示

    Ossutil はオブジェクトと UploadID をバケットに一覧表示することができます。 デフォルトでは、オブジェクトが表示されます。 UploadID を表示するには -m オプションを使用し、オブジェクトと UploadID を同時に表示するには -a オプションを使用します。

    • オブジェクトの一覧表示
      ./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
    • オブジェクトとマルチパーツの一覧表示
      ./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 オプションを使用します。

      レベル 1 ディレクトリのコンテンツを表示するには、-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
  • バケットの ACL の設定

    バケットが作成されると、そのバケットのデフォルト ACL は "private" となります。 set-acl コマンドを実行することで、バケットの ACL を変更できます。バケットの ACL を設定するには、-b オプションを指定する必要があります。

    bucket 1 に "private" 権限を許可します。

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

    ACL の設定に関する詳細を表示するには、help set set-acl コマンドを実行します。