初始化上传段任务
功能介绍
使用多段上传特性时，用户必须首先调用创建多段上传任务接口创建任务，系统会给用户返回一个全局唯一的多段上传任务号，作为任务标识。后续用户可以根据这个标识发起相关的请求，如：上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象；同一个对象可以同时存在多个多段上传任务；每个多段上传任务在初始化时可以附加消息头信息，包括acl、用户自定义元数据和通用的HTTP消息头contentType、contentEncoding等，这些附加的消息头信息将先记录在多段上传任务元数据中。
请求消息样式
1 2 3 4 |
POST /ObjectName?uploads HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization: authorization |
请求消息参数
该请求需要在消息中指定参数，表明这是多段上传，参数意义如表1所示。
请求消息头
该请求可以使用附加的消息头，具体如表2所示。
|
消息头名称 |
描述 |
是否必选 |
|---|---|---|
|
x-obs-acl |
初始化多段上传任务时，可以加上此消息头设置对象的权限控制策略，使用的策略为预定义的常用策略，包括：private；public-read；public-read-write。 类型：String 说明：字符串形式的预定义策略。 示例：x-obs-acl:public-read-write。 |
否 |
|
x-obs-grant-read |
初始化多段上传任务时，使用此头域授权domain下所有用户有读对象和获取对象元数据的权限 类型：String 示例：x-obs-grant-read: ID=domainID。如果授权给多个租户，需要通过“,”分割。 |
否 |
|
x-obs-grant-read-acp |
初始化多段上传任务时，使用此头域授权domain下所有用户有获取对象ACL的权限。 类型：String 示例：x-obs-grant-read-acp: ID=domainID。如果授权给多个租户，需要通过“,”分割。 |
否 |
|
x-obs-grant-write-acp |
初始化多段上传任务时，使用此头域授权domain下所有用户有写对象ACL的权限。 类型：String 实例x-obs-grant-write-acp: ID=domainID。如果授权给多个租户，需要通过“,”分割。 |
否 |
|
x-obs-grant-full-control |
初始化多段上传任务时，使用此头域授权domain下所有用户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限。 类型：String 示例：x-obs-grant-full-control: ID=domainID。如果授权给多个租户，需要通过“,”分割。 |
否 |
|
x-obs-website-redirect-location |
当桶设置了Website配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的URL，OBS将这个值从头域中取出，保存在对象的元数据中。 类型：String 默认值：无 约束：必须以“/”、“http://”或“https://”开头，长度不超过2K。 |
否 |
|
x-obs-expires |
表示对象的过期时间，单位是天。过期之后对象会被自动删除。（从对象最后修改时间开始计算） 类型：Integer 示例：x-obs-expires:3 |
否 |
|
x-obs-meta-* |
初始化上传段任务时，可以在HTTP请求中加入以“x-obs-meta-”开头的消息头，用来加入自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回消息的头中出现。 类型：String 示例：x-obs-meta-test: test metadata |
否 |
其他公共消息头请参考表3。
请求消息元素
该请求消息中不使用消息元素。
响应消息样式
1 2 3 4 5 6 7 8 9 10 11 |
HTTP/1.1 status_code Date: date Content-Length: length Connection: status <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <InitiateMultipartUploadResult xmlns="http://obs.region.example.com/doc/2015-06-30/"> <Bucket>BucketName</Bucket> <Key>ObjectName</Key> <UploadId>uploadID</UploadId> </InitiateMultipartUploadResult> |
响应消息头
该请求的响应消息使用公共消息头，具体请参考表1。
响应消息元素
该请求响应消息中通过返回消息元素，返回本次多段上传任务的多段上传任务号、桶名、对象名，供后续上传段、合并段使用，元素的具体意义如表3所示。
错误响应消息
1、如果AccessKey或签名无效，OBS返回403 Forbidden，错误码为AccessDenied。
2、如果桶不存在，OBS返回404 Not Found，错误码为NoSuchBucket。
3、检查用户是否具有指定桶的写权限，如果没有权限，OBS返回403 Forbidden，错误码为AccessDenied。
其他错误已包含在表2中。
请求示例：初始化段
1 2 3 4 |
POST /objectkey?uploads HTTP/1.1 Host: examplebucket.obs.region.example.com Date: WED, 01 Jul 2015 05:14:52 GMT Authorization: OBS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc= |
响应示例：初始化段
1 2 3 4 5 6 7 8 9 10 11 12 13 |
HTTP/1.1 200 OK Server: OBS x-obs-id-2: Weag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg== x-obs-request-id: 996c76696e6727732072657175657374 Date: WED, 01 Jul 2015 05:14:52 GMT Content-Length: 303 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <InitiateMultipartUploadResult xmlns="http://obs.region.example.com/doc/2015-06-30/"> <Bucket>bucketname</Bucket> <Key>objectkey</Key> <UploadId>DCD2FC98B4F70000013DF578ACA318E7</UploadId> </InitiateMultipartUploadResult> |
请求示例：初始化段的同时携带ACL
1 2 3 4 5 |
POST /objectkey?uploads HTTP/1.1 Host: examplebucket.obs.region.example.com Date: WED, 01 Jul 2015 05:15:43 GMT x-obs-grant-write-acp:ID=52f24s3593as5730ea4f722483579ai7,ID=a93fcas852f24s3596ea8366794f7224 Authorization: OBS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc= |
响应示例：初始化段的同时携带ACL
1 2 3 4 5 6 7 8 9 10 11 12 13 |
HTTP/1.1 200 OK Server: OBS x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTnv+daB51p+IVhAvWN7s5rSKhcWqDFs x-obs-request-id: BB78000001648457112DF37FDFADD7AD Date: WED, 01 Jul 2015 05:15:43 GMT Content-Length: 303 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <InitiateMultipartUploadResult xmlns="http://obs.region.example.com/doc/2015-06-30/"> <Bucket>bucketname</Bucket> <Key>objectkey</Key> <UploadId>000001648453845DBB78F2340DD460D8</UploadId> </InitiateMultipartUploadResult> |
