stat コマンドは、バケットまたはオブジェクトの説明を取得する場合に使用します。 たとえば、stat コマンドを実行して、set-meta コマンドで設定されたオブジェクトメタデータを確認できます。

コマンド構文

./ossutil stat oss://bucket[/object] [--encoding-type url] [--payer requester] [-c file]

  • バケットの情報を取得する
     ./ossutil stat oss://bucket1
  • 特定のオブジェクトの情報を取得する
    ./ossutil stat oss://bucket1/object
  • 名前に特殊文字が含まれるオブジェクトの情報を取得する
    ossutil は、オブジェクト名の URL エンコードのみをサポートします。 オブジェクト名に特殊文字が含まれている場合、コマンドでオブジェクト名を使用する前にこれらの特殊文字をエンコードできます。
    ./ossutil stat oss://bucket1/%E7%A4%BA%E4%BE%8B.txt --encoding-type url
    重要 バケット名は URL エンコードできません。
  • バージョン管理が有効になっているバケットにあるオブジェクトの特定バージョンを表示する
    ./ossutil stat oss://bucket1/test.jpg --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk
    --version-id オプションを使用するには、ls --all-versions コマンドを実行して、使用可能な全オブジェクトバージョンを取得する必要があります。
    --version-id オプションは、バージョン管理が有効になっているバケット内のオブジェクトにのみ使用できます。 バケットのバージョン管理を有効にするコマンドの詳細は、「bucket-versioning」をご参照ください。

一般的なオプション

次の表に、stat コマンドに追加できるオプションを示します。
オプション 説明
--encoding-type オブジェクト名のエンコードタイプを指定します。 このオプションを指定する場合、値は url でなければなりません。 このオプションが指定されていない場合、オブジェクト名はエンコードされません。 バケット名は URL エンコードできません。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
  • info:プロンプトログを生成します。
  • debug:対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
--retry-times 操作が失敗した場合に操作を再試行する回数を指定します。 有効値:1~500。 デフォルト値:10。
--version-id バージョン管理が有効になっているバケットにあるオブジェクトのバージョン ID を指定します。
--payer リクエストの支払者を指定します。 pay-by-requester モードを有効にするには、このオプションを requester に設定します。
--proxy-host プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例:http://120.79. **.**:3128、socks5://120.79. **. **:1080 など。
--proxy-user プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。
--proxy-pwd プロキシサーバーのパスワードを指定します。 デフォルト値は null です。
一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。