
# 列举示例
本章节案例中的所有命令均以Linux操作系统为例，提供列举操作指导。
假设bucket-test桶内包含如下对象：
```
obs://bucket-test/test1.txt
obs://bucket-test/test2.txt
obs://bucket-test/test3.txt
obs://bucket-test/test4.txt
obs://bucket-test/test5.txt
obs://bucket-test/test6.txt
obs://bucket-test/src1/
obs://bucket-test/src1/test7.txt
obs://bucket-test/src2/
obs://bucket-test/src2/test8.txt
```
基于以上对象格式，不同场景下列举对象的命令示例如下：
- 只列举bucket-test桶中的3个对象，列举命令如下：
  ```
  ./obsutil ls obs://bucket-test -limit=3
  ```
  返回结果按照对象名和版本号以字典序排列后，结果如下：
  ```
  obs://bucket-test/test1.txt
  obs://bucket-test/test2.txt
  obs://bucket-test/test3.txt
  ```
  
- 列举bucket-test桶中从test3.txt之后的3个对象，列举命令如下：
  ```
  ./obsutil ls obs://bucket-test -limit=3 -marker=test3.txt
  ```
  返回结果按照对象名和版本号以字典序排列后，结果如下：
  ```
  obs://bucket-test/test4.txt
  obs://bucket-test/test5.txt
  obs://bucket-test/test6.txt
  ```
  
- 只列举bucket-test桶根目录下的文件和子目录，不进行递归操作，即不列举子目录下的内容，列举命令如下：
  ```
  ./obsutil ls obs://bucket-test -d
  ```
  返回结果按照对象名和版本号以字典序排列后，结果如下：
  ```
  obs://bucket-test/test1.txt
  obs://bucket-test/test2.txt
  obs://bucket-test/test3.txt
  obs://bucket-test/test4.txt
  obs://bucket-test/test5.txt
  obs://bucket-test/test6.txt
  obs://bucket-test/src1/
  obs://bucket-test/src2/
  ```
  
 
