股票代码: 836286    股票简称: 易云股份
官方微信

扫一扫关注易云捷讯官方微信

备案 |       管理控制台
API 手册
 

初始化分片

上传Object可以选择将Object分为多段分别进行上传,互不干扰,最后再进行合并。

在上传操作之前需要初始化一个多段上传的任务,这个任务包含任务ID以及初始化Object的少量信息(Object名字等)。后面的上传等一系列操作都需要携带这个任务的一些信息。

请求消息

请求格式

POST ?uploads  HTTP/1.1

Host: eos.eayun.com

Date: {Date}

Authorization: AWS {access-key}:{hash-of-header-and-secret}

请求消息头

参考公共请求消息头

TODO:x-amz-website-redirect-location

请求参数

参数名字

描述

必选

uploads

指定为多段上传

请求消息元素

该请求无消息元素

响应消息

响应格式

HTTP/1.1 status_code

Date: {Date}

Content-Length: length

Connection: status


<?xml version="1.0" encoding="UTF-8"?>

<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

<Bucket>BucketName</Bucket>

<Key>ObjectName</Key>

<UploadId>uploadID</UploadId>

</InitiateMultipartUploadResult>

响应消息头

请参考公共响应消息头

响应消息元素

元素名字

描述

InitiateMultipartUploadResult

指多端上传任务的标签

Bucket

多段上传Object所属的Bucket

Key

多段上传Object的名字

UploadId

多段上传任务的ID,后面进行上传时需要此ID

错误响应消息

请参考错误响应描述

另外:

• 如果AccessKey或签名无效,EOS返回403 Forbidden,错误码为AccessDenied。

• 如果Bucket不存在,EOS返回404 Not Found,错误码为NoSuchBucket。

• 检查用户是否具有指定Bucket的写权限,如果没有权限,EOS返回403 Forbidden,错误码为AccessDenied。

示例:

初始化一个多段上传任务,最终上传的Object是/testbucket/partup。

请求实例

POST /partup?uploads HTTP/1.1

Host: testbucket.eos.eayun.com

User-Agent: curl/7.43.0

Accept: */*

Authorization: AWS G7HGAZI01NOYBNWQ4EJD:26ZTk/WviI7BL62mA+0ALsngMZ0=

Date: Fri, 20 Nov 2015 03:20:23 +0000

Content-Type: application/octet-stream

响应实例

HTTP/1.1 200

Date: Fri, 20 Nov 2015 03:20:23 GMT

Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips

Connection: close

Transfer-Encoding: chunked

Content-Type: application/xml

Set-Cookie: RADOSGWLB=ceph1; path=/

<?xml version="1.0" encoding="UTF-8"?>

<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

<Bucket>testbucket</Bucket>

<Key>partup</Key>

<UploadId>2/AzrHB9uqM-t2KUmP0UV9vBfIu_RWwIA</UploadId>

</InitiateMultipartUploadResult>


© 2011-2017 易云捷讯科技(北京)股份有限公司, 版权所有 | © 2011-2017 Eayun,Inc. All rights reserved.

京公网安备 11010802022475号 | 京ICP备 11028869号

业务咨询:400-606-6396