list-objects（get-bucket）
list-objects命令用于列舉存儲(chǔ)空間（Bucket）中所有文件（Object）的信息。
注意事項(xiàng)
阿里云賬號(hào)默認(rèn)擁有列舉Bucket中的所有文件的信息。如果您需要通過RAM用戶或者STS的方式進(jìn)行查看，您必須擁有
oss:ListObjects權(quán)限。具體操作，請(qǐng)參見為RAM用戶授權(quán)自定義的權(quán)限策略。list-objects（get-bucket）已修訂為list-objects-v2（get-bucket-v2）。建議您在開發(fā)應(yīng)用程序時(shí)使用較新的版本list-objects-v2（get-bucket-v2）。為保證向后兼容性，OSS繼續(xù)支持list-objects（get-bucket）。
執(zhí)行list-objects（get-bucket）請(qǐng)求時(shí)不會(huì)返回Object中自定義的元信息。
命令格式
ossutil api list-objects --bucket value [flags]參數(shù) | 類型 | 說明 |
--bucket | string | Bucket的名稱。 |
--delimiter | string | 對(duì)Object名字進(jìn)行分組的字符。 |
--encoding-type | string | 對(duì)返回的內(nèi)容進(jìn)行編碼并指定編碼的類型。 |
--marker | string | 設(shè)定從marker之后按字母排序開始返回Object。 |
--max-keys | int | 指定返回Object的最大數(shù)。 |
--prefix | string | 限定返回文件的Key必須以Prefix作為前綴。 |
list-objects命令對(duì)應(yīng)API接口GetBucket（ListObjects）。關(guān)于API中的具體參數(shù)含義，請(qǐng)參見GetBucket (ListObjects)。
關(guān)于支持的全局命令行選項(xiàng)，請(qǐng)參見支持的全局命令行選項(xiàng)。
使用示例
以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中所有Object的信息。
ossutil api list-objects --bucket examplebucket以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中所有Object的信息，以JSON格式顯示。
ossutil api list-objects --bucket examplebucket --output-format json以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中所有Object的信息，以YAML格式顯示。
ossutil api list-objects --bucket examplebucket --output-format yaml以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中指定前綴dir下的所有Object的信息。
ossutil api list-objects --bucket examplebucket --prefix dir以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中指定前綴dir下，前100個(gè)Object的信息。
ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中當(dāng)前目錄下的Object的信息。
ossutil api list-objects --bucket examplebucket --delimiter/以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中指從test.txt之后的Object的信息。
ossutil api list-objects --bucket examplebucket --marker test.txt以下示例展示了如何列舉存儲(chǔ)空間examplebucket 中所有Object的信息，并對(duì)Object的名字進(jìn)行URL編碼。
ossutil api list-objects --bucket examplebucket --encoding-type url