获取对象列表

功能说明

获取指定 Bucket 下的所有 Objects。

方法原型

  1. func (s *BucketService) Get(ctx context.Context, opt *BucketGetOptions) (*BucketGetResult, *Response, error)

请求示例

  1. opt := &cos.BucketGetOptions{
  2.     Prefix:  "test",
  3.     MaxKeys: 100,                                
  4. }
  5. v, resp, err := client.Bucket.Get(context.Background(), opt)

参数说明

  1. type BucketGetOptions struct {
  2.     Prefix       string 
  3.     Delimiter    string 
  4.     EncodingType string 
  5.     Marker       string 
  6.     MaxKeys      int    
  7. }
参数名称参数描述类型必填
Prefix默认为空，对 object 的 key 进行筛选，匹配 prefix 为前缀的 objectsstring否
Delimiter默认为空，设置分隔符，比如设置/来模拟文件夹string否
EncodingType默认不编码，规定返回值的编码方式，可选值：urlstring否
Marker默认以 UTF-8 二进制顺序列出条目，标记返回 objects 的 list 的起点位置string否
MaxKeys最多返回的 objects 数量，默认为最大的1000int否
#### 返回结果说明 
  1. type BucketGetResult struct {
  2.     Name           string
  3.     Prefix         string 
  4.     Marker         string 
  5.     NextMarker     string 
  6.     Delimiter      string 
  7.     MaxKeys        int
  8.     IsTruncated    bool
  9.     Contents       []Object 
  10.     CommonPrefixes []string 
  11.     EncodingType   string
    }
参数名称参数描述类型
NameBucket 名称，由 bucketname-appid 构成string
Prefix默认为空，对 object 的 key 进行筛选，匹配 prefix 为前缀的 objectsstring
Marker默认以 UTF-8 二进制顺序列出条目，标记返回 objects 的 list 的起点位置string
NextMarker当 IsTruncated 为 true 时，标记下一次返回 objects 的 list 的起点位置string
Delimiter默认为空，设置分隔符，比如设置/来模拟文件夹string
MaxKeys最多返回的 objects 数量，默认为最大的1000int
IsTruncated表示返回的 objects 否被截断bool
Contents包含所有 object 元信息的list，每个Object类型包括 ETag，StorageClass，Key，Owner，LastModified，Size等信息[]Object
CommonPrefixes所有以 Prefix 开头，以 Delimiter 结尾的 Key 被归到同一类[]string
EncodingType默认不编码，规定返回值的编码方式，可选值：urlstring