

喜讯:国内、香港、海外云服务器租用特惠活动,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云智能建站>>>,或咨询在线客服了解详情。 相关阅读
猜您喜欢
|



湘公网安备43019002001857号
备案号:
客服1