du コマンドは、バケットまたはディレクトリ内のすべてのオブジェクトの合計サイズをクエリします。
使用方法
バケットまたはディレクトリ内のすべてのオブジェクトの現在のバージョンの合計サイズをクエリするには、
oss:ListObjects、oss:ListParts、およびoss:ListMultipartUploads権限が必要です。 バケットまたはディレクトリ内のすべてのオブジェクトのバージョンの合計サイズをクエリするには、oss:ListObjectVersions、oss:ListParts、およびoss:ListMultipartUploads権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。ossutil 1.6.16 以降では、コマンドラインでバイナリ名として ossutil を直接使用できます。オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。ossutil 1.6.16 より前のバージョンでは、オペレーティングシステムに対応するバイナリ名を指定する必要があります。詳細については、「ossutil コマンドリファレンス」をご参照ください。
コマンド構文
ossutil du oss://bucketname[/prefix] [--payer requester] [--all-versions][--block-size <value>]次の表は、コマンド構文のパラメーターとオプションについて説明しています。
パラメーター/オプション | 説明 |
bucketname | バケットの名前。 |
prefix | オブジェクト名のディレクトリまたはプレフィックス。 |
--payer | リクエストの支払者。 指定されたパス内のリソースにアクセスするリクエスト者がトラフィックとリクエストの料金を支払うようにするには、このオプションを requester に設定します。 |
--all-versions | コマンドがすべてのバージョンのオブジェクトの合計サイズをクエリすることを指定します。 このオプションを指定しない場合、現在のバージョンのオブジェクトの合計サイズのみがクエリされます。 |
--block-size | 指定されたバケットまたはディレクトリ内のオブジェクトの合計サイズの単位。 有効な値：KB、MB、GB、TB。 このオプションを指定しない場合、オブジェクトのサイズはバイト単位で測定されます。 重要 このオプションは、ossutil 1.7.3 以降で使用できます。 |
バケット内のすべてのバージョンのオブジェクトの合計サイズをクエリする
次のサンプルコマンドを実行して、examplebucket バケット内のすべてのバージョンのオブジェクトの合計サイズをクエリできます。
ossutil du oss://examplebucket --all-versions次の出力例は、バケットに合計 13 個のオブジェクト（標準オブジェクト 12 個とアーカイブオブジェクト 1 個）が含まれており、合計サイズが 132,116,024 バイトであることを示しています。
storage class object count sum size(byte)
----------------------------------------------------------
Standard 12 132115210
Archive 1 814
----------------------------------------------------------
total object count: 13 total object sum size: 132116024
total part count: 0 total part sum size: 0
total du size(byte):132116024
0.382978(s) elapsedディレクトリ内のオブジェクトの現在のバージョンの合計サイズをクエリする
次のサンプルコマンドを実行して、examplebucket という名前のバケットの dir ディレクトリにあるオブジェクトの現在のバージョンの合計サイズをクエリできます。 取得したサイズは GB 単位で測定されます。
ossutil du oss://examplebucket/dir/ --block-size GB次の出力例は、バケットの dir ディレクトリに合計 5 つの標準オブジェクトが含まれており、合計サイズが 0.0002 GB であることを示しています。
storage class object count sum size(byte)
----------------------------------------------------------
Standard 5 232277
----------------------------------------------------------
total object count: 5 total object sum size: 232277
total part count: 0 total part sum size: 0
total du size(GB):0.0002
0.078757(s) elapsed名前に特定のプレフィックスが含まれるすべてのバージョンのオブジェクトの合計サイズをクエリする
次のコマンドを実行して、examplebucket という名前のバケットに test プレフィックスが含まれるすべてのバージョンのオブジェクトの合計サイズをクエリできます。 取得したサイズは KB 単位で測定されます。
ossutil du oss://examplebucket/test --all-versions --block-size KB次の出力例は、名前に test プレフィックスが含まれる 4 つの標準オブジェクトが examplebucket バケットに格納されており、これらのオブジェクトの合計サイズが 448.1455 KB であることを示しています。
storage class object count sum size(byte)
----------------------------------------------------------
Standard 4 439425
----------------------------------------------------------
total object count: 4 total object sum size: 439425
total part count: 0 total part sum size: 0
total du size(KB):448.1455
0.126340(s) elapsed共通オプション
ossutil を使用して別のリージョンにあるバケットに切り替える場合は、-e オプションを追加して、バケットがあるリージョンのエンドポイントを指定します。 ossutil を使用して別の Alibaba Cloud アカウントに属するバケットに切り替える場合は、-i オプションを追加して、指定したアカウントの AccessKey ID を指定し、-k オプションを追加して、指定したアカウントの AccessKey シークレットを指定します。
たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別の Alibaba Cloud アカウントが所有する testbucket という名前のバケット内のすべてのバージョンのオブジェクトの合計サイズをクエリできます。
ossutil du oss://testbucket --all-versions -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret共通オプションの詳細については、「共通オプション」をご参照ください。