ListMultipartUploads
所有文档

          对象存储 BOS

          ListMultipartUploads

          接口描述

          此命令用于列出指定Bucket下面的所有未执行完成的Multipart Upload。“未执行完”是指完成了InitMultipartUpload,但是还没有调用CompleteMultipartUpload或AbortMultipartUpload的Multipart Upload。每次BOS最多返回1000个Multipart Upload,BOS支持prefix和delimiter过滤。

          请求(Request)

          • 请求语法

            GET /?uploads HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            Date: <Date>
            Authorization: <Authorization_String>
          • 请求头域

            无特殊要求头域

          • 请求参数

            名称 类型 参数位置 描述 是否必需
            delimiter String Query参数 分隔符; 主要应此项实现list文件夹的逻辑
            keyMarker String Query参数 Object按照字典序排序后,本次从keyMarker的后面的一条开始返回
            maxUploads Int Query参数 本次请求返回Multipart Uploads的最大数目,默认1000,最大1000
            prefix String Query参数 key前缀,限定返回的object key必须以此为前缀
            uploads String Query参数 标明请求是 ListMultipartUploads

          响应(Response)

          • 响应头域

            无特殊头域

          • 响应元素

            名称 类型 描述
            bucket String 所属Bucket名称
            commonPrefixes - 如果在请求的时候指定了delimiter,将返回此项。BOS把匹配到的Object名称
            按照一定规则(从preifx到第一个delimiter)截取,截取的字符串去重作为CommonPrefixes的数据返回
            delimiter String 返回请求中的delimiter值
            prefix String object前缀
            isTruncated Bool 标明是否本次是否没有返回所有的数据。
            true表示本次没有返回全部结果; false表示本次已经返回了全部结果
            keyMarker String 请求指定的本次返回的MultipartUpload的起始位置
            maxUploads Int 请求指定的本次返回的Multipart Uploads的最大数目
            nextKeyMarker String 本次返回的最后一条MultipartUpload,可以作为下一次请求的KeyMarker
            uploads Container 保存一个MultipartUpload的容器
            +key String Object名称
            +uploadId String MultipartUpload的ID
            +owner Container Object所属的用户信息
            ++displayName String 用户名
            ++id String 用户ID
            +initiated Date 本次MultipartUpload开始时间
            +storageClass String Object的存储类型,低频存储返回STANDARD_IA,冷存储返回COLD,标准存储返回STANDARD,归档类型返回ARCHIVE;如果是多AZ类型bucket,多AZ低频存储返回MAZ_STANDARD_IA,多AZ标准存储返回MAZ_STANDARD

            注意事项:此处的Delimiter跟ListObjects的类似,可以参考ListObjects的接口说明。

          示例

          • 请求示例

            GET /?uploads HTTP/1.1
            Host: BucketName.bj.bcebos.com
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Authorization: AuthorizationString
          • 响应示例(JSON)

            HTTP/1.1 200 OK
            x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Content-Length: 1330
            Connection: keep-alive
            Server: BceBos
            
            {
              "bucket":"bucket",
              "keyMarker":"",
              "nextKeyMarker":"my-movie.m2ts",
              "maxUploads":3,
              "isTruncated":true,
              "uploads": [
                  {
                      "key":"my-divisor",
                      "uploadId":"a44cc9bab11bdc157676984aad851637",
                      "owner":{
                          "id":"75aa57f09aa0c8caeab4aeebf76c078efc7c6caea54ba06a",
                          "displayName":"OwnerDisplayName"
                      },
                      "initiated":"2010-11-10T20:48:33Z"
                      "storageClass" : "STANDARD_IA",
                  },
                  {
                      "key":"my-movie",
                      "uploadId":"b44cc9bab11cbd156984767aad637851",
                      "owner":{
                          "id":"b1d16700c70b0b05597d7acd6a3f92be",
                          "displayName":"OwnerDisplayName"
                      },
                      "initiated":"2010-11-10T20:48:33Z"
                      "storageClass" : "STANDARD",
                  },
                  {
                      "key":"my-movie.m2ts",
                      "uploadId":"c41cc9aad11cbd637851767bab156984",
                      "owner":{
                          "id":"b1d16700c70b0b05597d7acd6a3f92be",
                          "displayName":"OwnerDisplayName"
                      },
                      "initiated":"2010-11-10T20:49:33Z"
                      "storageClass" : "STANDARD_IA",
                  }
              ]
            }
          上一篇
          ListParts
          下一篇
          图像审核服务接口