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 で、ログファイルが生成されないことを示します。 有効値:
|
--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 です。 |
注 一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。