对象存储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

      注意事项:此处的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
    下一篇
    图像审核服务接口