列出分块

功能说明

列出指定 UploadId 中已经上传的分块的信息。

方法原型

  1. func (s *ObjectService) ListParts(ctx context.Context, name, uploadID string) (*ObjectListPartsResult, *Response, error)

请求示例

  1. key := "test/test_list_parts.go"
  2. v, resp, err := client.Object.ListParts(context.Background(), key, uploadID)

参数说明

参数名称参数描述类型必填
key对象键（Key）是对象在存储桶中的唯一标识。例如，在对象的访问域名 bucket1-1250000000.cos.ap-guangzhou.myqcloud.com/doc1/pic1.jpg 中，对象键为 doc1/pic1.jpgstring是
UploadId标识分块上传的 ID，由 InitiateMultipartUpload 生成string是

返回结果说明

  1. type ObjectListPartsResult struct {
  2.     Bucket               string
  3.     EncodingType         string 
  4.     Key                  string
  5.     UploadID             string     
  6.     Initiator            *Initiator 
  7.     Owner                *Owner     
  8.     StorageClass         string
  9.     PartNumberMarker     int
  10.     NextPartNumberMarker int 
  11.     MaxParts             int
  12.     IsTruncated          bool
  13.     Parts                []Object 
  14. }
  15. type Initiator struct {
  16.     UIN         string
  17.     ID          string 
  18.     DisplayName string                                
  19. }
  20. type Owner struct {
  21.     UIN         string
  22.     ID          string 
  23.     DisplayName string                                
  24. }
  25. type Object struct {
  26.     Key          string 
  27.     ETag         string 
  28.     Size         int    
  29.     PartNumber   int    
  30.     LastModified string 
  31.     StorageClass string 
  32.     Owner        *Owner
  33. }
参数名称参数描述类型
BucketBucket 名称，由 bucketname-appid 构成string
EncodingType默认不编码，规定返回值的编码方式，可选值：urlstring
Key对象键（Key）是对象在存储桶中的唯一标识。例如，在对象的访问域名 bucket1-1250000000.cos.ap-guangzhou.myqcloud.com/doc1/pic1.jpg 中，对象键为 doc1/pic1.jpgstring
UploadId标识分块上传的 ID，由 InitiateMultipartUpload 生成string
Initiator分块上传的创建者，包括 DisplayName，UIN 和 IDstruct
Owner文件拥有者的信息，包括 DisplayName ，UIN和 IDstruct
StorageClass文件的存储类型，STANDARD、STANDARD_IA，默认值：STANDARDstring
PartNumberMarker默认为0，从第一块列出分块，从 PartNumberMarker 下一个分块开始列出int
NextPartNumberMarker指明下一次列出分块的起始位置int
MaxParts最多返回的分块的数量，默认为最大的1000int
IsTruncated表示返回的分块是否被截断bool
Part上传分块的相关信息，包括 ETag，PartNumber，Size，LastModifiedstruct