我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!


喜讯:国内、香港、海外云服务器租用特惠活动,2核/4G/10M仅需31元每月,点击抢购>>>

点击这里注册天翼云特邀VIP帐号,立即体验天翼云对象存储>>>


天翼云对象存储(经典版)I型API参考-POST Object


POST操作使用HTML表单将对象上传到指定的Bucket。POST是另一种形式的PUT操作,POST可以让使用者通过Browser-based的方式,将对象上传到指定bucket中。PUT的参数是通过HTTP Header提交的,而POST通过使用multipart/form-data编码的消息体中的字段进行提交。用户必须对操作的Bucket有写权限。OOS不存储部分对象:如果收到成功的响应,那么对象就是存储成功了。

为了保证数据在网络传输过程中没有损坏,可以使用Content-MD5字段进行校验。如果请求参数中有Content-MD5,OOS将会计算用户提交的对象的MD5值。如果计算出的值与用户提供的值不一致,OOS将会返回一个错误给用户。或者,用户可以在上传对象到OOS时计算对象的MD5值,并与OOS在响应中返回的ETag进行比较。ETag是对象内容的MD5值,不包括metadata。

请求语法

POST   /HTTP/1.1

Host:   BucketName.oos-cn.ctyunapi.cn

User-Agent:   browser_data

Accept:   file_types

Accept-Language:   Regions

Accept-Encoding:   encoding

Accept-Charset:   character_set

Keep-Alive:   300

Connection:   keep-alive

Content-Type:   multipart/form-data; boundary=9431149156168

Content-Length: length

 

--9431149156168

Content-Disposition:   form-data; name="key"

 

Key

--9431149156168

Content-Disposition:   form-data; name="success_action_redirect"

 

success_redirect

--9431149156168

Content-Disposition:   form-data; name="Content-Type"

 

content_type

--9431149156168

Content-Disposition:   form-data; name="x-amz-meta-uuid"

 

uuid

--9431149156168

Content-Disposition:   form-data; name="x-amz-meta-tag"

 

metadata

--9431149156168

Content-Disposition:   form-data; name="AWSAccessKeyId"

 

access-key-id

--9431149156168

Content-Disposition:   form-data; name="Policy"

 

encoded_policy

--9431149156168

Content-Disposition:   form-data; name="Signature"

 

signature=

--9431149156168

Content-Disposition:   form-data; name="file"; filename="MyFilename.jpg"

Content-Type:   image/jpeg

 

file_content

--9431149156168

Content-Disposition:   form-data; name="submit"

 

Upload   to OOS

--9431149156168—

表单字段

说明:表单中指定的每个表单字段(AWSAccessKeyId、签名、文件、策略和带x-ignore-前缀的字段名称除外)必须包含在policy条件列表中,两者需要保持一致。

名称

描述

是否必须

AWSAccessKeyId

根用户或拥有权限的子用户的访问密钥ID。如果请求包含Policy,对于V2签名,则此字段为必填字段。

类型:字符串

条件

Cache-Control,

Content-Type, Content-Disposition, Content-Encoding,   Expires

特定于REST的请求头。有关更多信息,请参阅PUT Object。

类型:字符串

file

文件或文本内容。文件或文本内容必须是Form表单的最后一个字段。一次只能上传一个文件。

类型:文件或文本内容

key

上传对象的名称。

可以使用${filename}变量来使用用户提供的文件名。例如,如果用户Betty上传的文件名为lolcatz.jpg, 字段值指定为/user/betty/${filename},那么保存的对象名称将会是/user/betty/lolcatz.jpg。

类型:字符串

policy

描述请求中允许的内容的安全策略。对于非匿名请求,Policy字段是必须的。

Policy的设置参见Bucket Policy安全策略

类型:字符串

条件

signature

使用AWSAccessKeyId对应的秘钥对policy的签名。如果请求包含Policy,对于V2签名,则此字段为必填字段。

signature   = Base64(HMAC-SHA1(YourSecrectKey,policy)),具体计算方法请查看用户签名验证(V2)和用户签名验证(V4)。

条件

X-Amz-Algorithm

签名算法。如果请求包含Policy,对于V4签名,则此字段为必填字段。

取值:AWS4-HMAC-SHA256。

条件

X-Amz-Credential

用户的accessKeyId和范围信息,范围信息包括请求日期、区域、服务、终止字符串aws4_request,格式如下:

<your-access-key-id>/<date>/<region>/<service>/aws4_request

其中:

l  date格式为YYYYMMDD。

l  region:

n  对于oos api:访问域名为oos-xx.ctyunapi.cn,region为xx。各资源池的详细访问域名详见 Endpoint列表;

推荐:TOP云智能建站优惠活动,仅880元即可搭建一个后台管理五端合一的智能网站(PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序),独享百度搜索SEO优势资源,让你的网站不仅有颜值有排面,更有排名,可以实实在在为您带来效益,请点击进入TOP云智能建站>>>,或咨询在线客服了解详情。



我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!

在线客服
联系方式

热线电话

131-3501-0006

上班时间

周一到周五

公司电话

130-0743-9476

二维码
线