Skip to Content
对象存储 US3initiate_multipart_upload

初始化分片 - InitiateMultipartUpload

简介

初始化分片上传

定义

句法（Syntax）:

POST /<object_name>?uploads HTTP/1.1
Host: <bucket_name>.cn-bj.ufileos.com
Authorization: <token>
Content-Length: 0

请求参数（Request Parameters）

请求头（Request Headers）

NameTypeDescriptionRequired
AuthorizationString上传请求的授权签名，API 签名算法Yes
Content-LengthInteger请求body部分的长度No
X-Ufile-Storage-ClassString文件存储类型，分别是标准、低频、归档，对应有效值：STANDARD, IA, ARCHIVENo
X-Ufile-Meta- *StringUS3中规定所有以X-Ufile-Meta-为前缀的参数视为用户自定义元数据（User Meta），比如x-ufile-meta-location。一个文件可以有多个类似的参数，但所有的User Meta总大小不能超过8KB。这些User Meta信息会在GetFile或者HeadFile的时候在HTTP头部中返回。No

请求元素（Request Elements）

说明：未使用。

响应（Responses）

响应头（Response Headers）

NameTypeDescription
Content-TypeString响应body部分的类型
Content-LengthInteger响应body部分的长度
X-SessionIdString请求失败时返回本次请求的会话Id

响应元素（Response Elements）

NameTypeDescription
UploadIdString本次分片上传的上传Id
BlkSizeInteger分片的块大小
BucketString上传文件所属Bucket的名称
KeyString上传文件在Bucket中的Key名称

示例

请求示例（Example Request）:

POST /demokey?uploads HTTP/1.1
Host: <bucket_name>.cn-bj.ufileos.com
Authorization:  demouser@ucloud.cn13424346821929713944:S5FVD2w613MKb/hisjaqHdjvn9U=
Content-Length: 0

响应示例（Example Response）:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 121

{
    "UploadId": "0f188eb2-5e19-49c3-94c9-36fb5a0ff72a",
    "BlkSize": 4194304,
    "Bucket": "demobucket",
    "Key": "demokey"
}
head_filelist_objects