duコマンドは、バケットまたはディレクトリ内のすべてのオブジェクトの合計サイズを照会します。
使用上の注意
バケットまたはディレクトリ内のすべての現在のバージョンのオブジェクトの合計サイズを照会するには、
oss:ListObjects、oss:ListParts、およびoss:ListMultipartUploads権限が必要です。 バケットまたはディレクトリ内のすべてのバージョンのオブジェクトの合計サイズを照会するには、oss:ListObjectVersions、oss:ListParts、およびoss:ListMultipartUploads権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合は、オペレーティングシステムに対応するバイナリ名を指定する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。
コマンド構文
ossutil du oss://bucketname[/prefix] [--payer requester] [--all-versions][--block-size <value>]次の表に、コマンド構文のパラメーターとオプションを示します。
パラメータ /オプション | 説明 |
bucketname | バケットの名前です。 |
プレフィックス | オブジェクトの名前のディレクトリまたはプレフィックス。 |
-- 支払人 | リクエストの支払人。 指定したパスのリソースにアクセスするリクエスタにトラフィックとリクエストの料金を支払う場合は、このオプションをrequesterに設定します。 |
-すべてのバージョン | コマンドがオブジェクトのすべてのバージョンの合計サイズを照会するように指定します。 このオプションを指定しない場合、現在のバージョンのオブジェクトの合計サイズのみが照会されます。 |
-- ブロックサイズ | 指定されたバケットまたはディレクトリ内のオブジェクトの合計サイズの単位。 有効な値: 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つのStandardオブジェクトが含まれており、その合計サイズは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という名前のバケット内の名前にテストプレフィックスが含まれているオブジェクトのすべてのバージョンの合計サイズを照会できます。 得られたサイズはKBで測定されます。
ossutil du oss://examplebucket/test --all-versions --block-size KB次のサンプル出力は、名前にテストプレフィックスが含まれる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 secretを指定します。
たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有するtestbucketという名前のバケット内のすべてのバージョンのオブジェクトの合計サイズを照会できます。
ossutil du oss://testbucket --all-versions -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****共通オプションの詳細については、「共通オプション」をご参照ください。