查询分块上传

功能说明

查询指定 Bucket 下的所有正在进行中的分块上传。

方法原型

  1. func (s *BucketService) ListMultipartUploads(ctx context.Context, opt *ListMultipartUploadsOptions) (*ListMultipartUploadsResult, *Response, error)

请求示例

  1. opt := &cos.ListMultipartUploadsOptions{
  2.     Prefix: "test",
  3. }
  4. v, resp, err := client.Bucket.ListMultipartUploads(context.Background(), opt)

参数说明

  1. type ListMultipartUploadsOptions struct {
  2.     Delimiter      string 
  3.     EncodingType   string 
  4.     Prefix         string 
  5.     MaxUploads     int    
  6.     KeyMarker      string 
  7.     UploadIDMarker string 
  8. }
参数名称参数描述类型必填
Delimiter默认为空，设置分隔符string否
EncodingType默认不编码，规定返回值的编码方式，可选值：urlstring否
Prefix默认为空，对分块上传的 key 进行筛选，匹配 prefix 为前缀的分块上传string否
MaxUploads最多返回的分块上传的数量，默认为最大的1000int否
KeyMarker和 UploadIdMarker 一起使用，指明列出分块上传的起始位置string否
UploadIdMarker和 KeyMarker 一起使用，指明列出分块上传的起始位置。如果没有指定 KeyMarker，UploadIdMarker 会被忽略string否

返回结果说明

  1. type ListMultipartUploadsResult struct {
  2.     Bucket             string   
  3.     EncodingType       string   
  4.     KeyMarker          string
  5.     UploadIDMarker     string 
  6.     NextKeyMarker      string
  7.     NextUploadIDMarker string 
  8.     MaxUploads         int
  9.     IsTruncated        bool
  10.     Uploads            []struct {
  11.         Key          string
  12.         UploadID     string 
  13.         StorageClass string
  14.         Initiator    *Initiator
  15.         Owner        *Owner
  16.         Initiated    string
  17.     } 
  18.     Prefix         string
  19.     Delimiter      string   
  20.     CommonPrefixes []string 
  21. }
参数名称参数描述类型
BucketBucket 名称，由 bucketname-appid 构成string
EncodingType默认不编码，规定返回值的编码方式，可选值：urlstring
KeyMarker和 UploadIdMarker 一起使用，指明列出分块上传的 key 起始位置string
UploadIdMarker和 KeyMarker 一起使用，指明列出分块上传的 uploadid 起始位置。如果没有指定 KeyMarker，UploadIdMarker 会被忽略string
NextKeyMarker当 IsTruncated 为 true 时，指明下一次列出分块上传的 key 的起始位置string
NextUploadIDMarker当 IsTruncated 为 true 时，指明下一次列出分块上传的 uploadid 的起始位置string
MaxUploads最多返回的分块上传的数量，默认为最大的1000int
IsTruncated表示返回的分块上传否被截断bool
Upload包含所有分块上传的 list，包括 UploadId，storageClass，Key，Owner，Initiator，Initiated 等信息[]struct
Prefix默认为空，对分块上传的 key 进行筛选，匹配 prefix 为前缀的分块上传string
Delimiter默认为空，设置分隔符string
CommonPrefixes所有以 Prefix 开头，以 Delimiter 结尾的 Key 被归到同一类[]string