本文介绍如何列举文件。

OSS文件按照字母顺序排列。您可以通过Bucket.ListObjects列出存储空间下的文件。主要的参数如下：

参数说明
delimiter对文件名称进行分组的一个字符。所有名称包含指定的前缀且第一次出现delimiter字符之间的文件作为一组元素（commonPrefixes）。
prefix限定返回的文件必须以prefix作为前缀。
maxKeys限定此次列举文件的最大个数。默认值为100，最大值为1000。
marker列举指定marker之后的文件。

ListObjects的完整代码请参见Github。

简单列举文件

您可以使用默认参数获取存储空间的文件列表，默认返回100条记录。代码如下：

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func HandleError(err error) {
  10.     fmt.Println("Error:", err)
  11.     os.Exit(-1)
  12. }
  14. func main() {
  15.     // 创建OSSClient实例。
  16.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  17.     if err != nil {
  18.         HandleError(err)
  19.     }
  21.     // 获取存储空间。
  22.     bucketName := "<yourBucketName>"
  23.     bucket, err := client.Bucket(bucketName)
  24.     if err != nil {
  25.         HandleError(err)
  26.     }
  28.     // 列举所有文件。
  29.     marker := ""
  30.     for {
  31.         lsRes, err := bucket.ListObjects(oss.Marker(marker))
  32.         if err != nil {
  33.             HandleError(err)
  34.         }
  36.         // 打印列举文件，默认情况下一次返回100条记录。 
  37.         for _, object := range lsRes.Objects {
  38.             fmt.Println("Bucket: ", object.Key)
  39.         }
  41.         if lsRes.IsTruncated {
  42.             marker = lsRes.NextMarker
  43.         } else {
  44.             break
  45.         }
  46.     }
  47. }

列举指定个数的文件

以下代码用于列举指定个数的文件：

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func main() {
  10.     // 创建OSSClient实例。
  11.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  12.     if err != nil {
  13.         fmt.Println("Error:", err)
  14.         os.Exit(-1)
  15.     }
  17.     bucketName := "<yourBucketName>"
  19.     // 获取存储空间。
  20.     bucket, err := client.Bucket(bucketName)
  21.     if err != nil {
  22.         fmt.Println("Error:", err)
  23.         os.Exit(-1)
  24.     }
  26.     // 设置列举文件的最大个数，并列举文件。
  27.     lsRes, err := bucket.ListObjects(oss.MaxKeys(200))
  28.     if err != nil {
  29.         fmt.Println("Error:", err)
  30.         os.Exit(-1)
  31.     }
  33.     // 打印结果。
  34.     fmt.Println("Objects:", lsRes.Objects)
  35.     for _, object := range lsRes.Objects {
  36.         fmt.Println("Object:", object.Key)
  37.     }
  38. }

列举指定前缀的文件

以下代码用于列举包含指定前缀（prefix）的文件：

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func main() {
  10.     // 创建OSSClient实例。
  11.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  12.     if err != nil {
  13.         fmt.Println("Error:", err)
  14.         os.Exit(-1)
  15.     }
  17.     bucketName := "<yourBucketName>"
  19.     // 获取存储空间。
  20.     bucket, err := client.Bucket(bucketName)
  21.     if err != nil {
  22.         fmt.Println("Error:", err)
  23.         os.Exit(-1)
  24.     }
  26.     // 列举包含指定前缀的文件。默认列举100个文件。
  27.     lsRes, err := bucket.ListObjects(oss.Prefix("my-object-"))
  28.     if err != nil {
  29.         fmt.Println("Error:", err)
  30.         os.Exit(-1)
  31.     }
  33.     // 打印结果。
  34.     fmt.Println("Objects:", lsRes.Objects)
  35.     for _, object := range lsRes.Objects {
  36.         fmt.Println("Object:", object.Key)
  37.     }
  38. }

列举指定marker之后的文件

参数marker代表文件名称。以下代码用于列举指定marker之后的文件：

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func main() {
  10.     // 创建OSSClient实例。
  11.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  12.     if err != nil {
  13.         fmt.Println("Error:", err)
  14.         os.Exit(-1)
  15.     }
  17.     bucketName := "<yourBucketName>"
  19.     // 获取存储空间。
  20.     bucket, err := client.Bucket(bucketName)
  21.     if err != nil {
  22.         fmt.Println("Error:", err)
  23.         os.Exit(-1)
  24.     }
  26.     // 列举指定marker之后的文件。默认列举100个文件。
  27.     lsRes, err := bucket.ListObjects(oss.Marker("my-object-xx"))
  28.     if err != nil {
  29.         fmt.Println("Error:", err)
  30.         os.Exit(-1)
  31.     }
  33.     // 打印结果。
  34.     fmt.Println("Objects:", lsRes.Objects)
  35.     for _, object := range lsRes.Objects {
  36.         fmt.Println("Object:", object.Key)
  37.     }
  38. }

分页列举所有文件

以下代码用于分页列举指定存储空间下的所有文件。每页列举的文件个数通过maxKeys指定。

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func main() {
  10.     // 创建OSSClient实例。
  11.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  12.     if err != nil {
  13.         fmt.Println("Error:", err)
  14.         os.Exit(-1)
  15.     }
  17.     bucketName := "<yourBucketName>"
  19.     // 获取存储空间。
  20.     bucket, err := client.Bucket(bucketName)
  21.     if err != nil {
  22.         fmt.Println("Error:", err)
  23.         os.Exit(-1)
  24.     }
  26.     // 分页列举所有文件。每页列举200个。
  27.     marker := oss.Marker("")
  28.     for {
  29.         lsRes, err := bucket.ListObjects(oss.MaxKeys(200), marker)
  30.         if err != nil {
  31.             fmt.Println("Error:", err)
  32.             os.Exit(-1)
  33.         }
  34.         marker = oss.Marker(lsRes.NextMarker)
  36.         fmt.Println("Objects:", lsRes.Objects)
  38.         if !lsRes.IsTruncated {
  39.             break
  40.         }
  41.     }
  42. }

分页列举指定marker之后的文件

以下代码用于分页列举指定maker之后的文件。每页列举的文件个数通过maxKeys指定。

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func main() {
  10.     // 创建OSSClient实例。
  11.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  12.     if err != nil {
  13.         fmt.Println("Error:", err)
  14.         os.Exit(-1)
  15.     }
  17.     bucketName := "<yourBucketName>"
  19.     // 获取存储空间。
  20.     bucket, err := client.Bucket(bucketName)
  21.     if err != nil {
  22.         fmt.Println("Error:", err)
  23.         os.Exit(-1)
  24.     }
  26.     // 分页列举指定maker之后的文件。每页列举200个。
  27.     marker = oss.Marker("my-object-xx")
  28.     for {
  29.         lsRes, err := bucket.ListObjects(oss.MaxKeys(50), marker)
  30.         if err != nil {
  31.             fmt.Println("Error:", err)
  32.             os.Exit(-1)
  33.         }
  35.         marker = oss.Marker(lsRes.NextMarker)
  37.         fmt.Println("Objects:", lsRes.Objects)
  39.         if !lsRes.IsTruncated {
  40.             break
  41.         }
  42.     }
  43. }

分页列举指定前缀的文件

以下代码用于分页列举包含指定前缀的文件。每页列举的文件个数通过maxKeys指定。

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func main() {
  10.     // 创建OSSClient实例。
  11.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  12.     if err != nil {
  13.         fmt.Println("Error:", err)
  14.         os.Exit(-1)
  15.     }
  17.     bucketName := "<yourBucketName>"
  19.     // 获取存储空间。
  20.     bucket, err := client.Bucket(bucketName)
  21.     if err != nil {
  22.         fmt.Println("Error:", err)
  23.         os.Exit(-1)
  24.     }
  26.     // 分页列举包含指定前缀的文件。每页列举80个。
  27.     prefix := oss.Prefix("my-object-")
  28.     marker := oss.Marker("")
  29.     for {
  30.         lsRes, err := bucket.ListObjects(oss.MaxKeys(80), marker, prefix)
  31.         if err != nil {
  32.             fmt.Println("Error:", err)
  33.             os.Exit(-1)
  34.         }
  36.         prefix = oss.Prefix(lsRes.Prefix)
  37.         marker = oss.Marker(lsRes.NextMarker)
  39.         fmt.Println("Objects:", lsRes.Objects)
  41.         if !lsRes.IsTruncated {
  42.             break
  43.         }
  44.     }
  45. }