所有文档

          对象存储 BOS

          InitiateMultipartUpload

          接口描述

          InitiateMultipartUpload是MultipartUpload的第一步,此命令向BOS请求一个全局唯一的UploadId,用于表示此次MultipartUpload,在MultipartUpload后续两个步骤都需要此UploadId,请求者也可以通过UploadId来查询上传的进度或者中断这次上传操作。

          请求(Request)

          • 请求语法

            POST /<ObjectName>?uploads HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            Date: <Date>
            Authorization: <AuthorizationString>
            Content-Type: text/plain
            Content-Length: <ContentLength>
            x-bce-storage-class: <StorageClass>
          • 请求头域

            名称 类型 描述 是否必需
            x-bce-storage-class String 指定BOS的对象的存储类型,目前支持STANDARDSTANDARD_IACOLDARCHIVE,默认为STANDARD;如果是多AZ类型bucket,MAZ_STANDARD_IA代表多AZ低频存储,不指定时默认是MAZ_STANDARD多AZ标准存储类型,不能是其它取值。
            x-bce-acl String CannedACL支持的header,用户设置Object的权限,取值为private或public-read。
            x-bce-grant-read String CannedACL支持的header,用户设置Object的读权限。支持多个id,以逗号分隔
            x-bce-grant-full-control String CannedACL支持的header,用户设置Object的FULL_CONTROL权限。支持多个id,以逗号分隔
            x-bce-server-side-encryption String 服务端加密算法,当前仅支持AES256。
            Cache-Control String 下载Object的Cache设置,常见的可取值为privateno-cachemax-agemust-revalidate
            Content-Disposition String 设置浏览器是否下载,可取值为inlineattachment; filename="download.txt"
            Expires String 设置下载Object时的缓存失效时间
          • 请求参数

            名称 类型 参数位置 描述 是否必需
            uploads String Query参数 分块上传的请求

          响应(Response)

          • 响应头域

          • 响应元素

            名称 类型 描述
            bucket String Bucket名称
            key String Object名称
            uploadId String 全局唯一ID,用于标识此次MultiUpload操作

            注意事项

            1. 使用MultipartUpload上传的Object,必须在第一步InitMultipartUpload时指定Content-Type,如不指定,默认为application/octet-stream
            2. InitiateMultipartUpload获取的UploadId将用于MultiUpload的后续2步操作,也可以用此UploadId来查询整个MultiUpload的进度和中断此次MultiUpload操作。

          示例

          • 标准存储的请求示例

            POST /ObjectName?uploads
            Host: BucketName.bj.bcebos.com
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Authorization: AuthorizationString
            Content-Length: 0
          • 低频/冷存储的请求示例

            POST /ObjectName?uploads
            Host: BucketName.bj.bcebos.com
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Authorization: AuthorizationString
            Content-Length: 0
            x-bce-storage-class: STANDARD_IA
          • 响应示例

            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: 197
            Connection: keep-alive
            Server: BceBos
            
            {
                "bucket": "BucketName",
                "key":"ObjectName",
                "uploadId": "a44cc9bab11cbd156984767aad637851"
            }
          上一篇
          使用指南
          下一篇
          UploadPart