功能说明

PostObject使用HTML表单向指定的桶上传一个对象。POST是PUT的另外一种选择，为了方便用户可以基于浏览器的表单上传对象， 参数通过POST以表单域的形式将数据编码封装到消息体传递。通过PostObject上传的Object大小不能超过5GB。

请求消息样式

POST /{Bucket} HTTP/1.1
Host: xxx.zos.ctyun.cn 
Connection: keep-alive
Content-Type: multipart/form-data; 
Content-Length: Content-Length
Content-Disposition: form-data; 
X-Amz-Date: Date
X-Amz-Content-SHA256: Content-SHA256 
Authorization: Auth String 

files: {
    "key": (None, Key),
    "x-amz-storage-class": (None, StorageClass),
    "success_action_status": SuccessActionStatus,
    "x-amz-meta-*": Value,
    "file": File
}

请求消息参数

请求消息头

该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。

请求消息元素

此接口请求体通过 multipart/form-data 编码，在 HTML 网页中通过 \<form> 元素发送请求时，需将 \<form> 元素的 enctype 属性设置为 multipart/form-data，随后使用 HTML 表单元素（例如 \<input>、\<select> 等）添加所需表单字段。

表单域files说明

响应样式说明

当success_action_status设为201时，返回如下：

HTTP/1.1 201
x-amz-version-id: VersionId 
<PostResponse>
    <Location>http://xxx.zos.ctyun.cn/Bucket/Key</Location>
    <Bucket>Bucket</Bucket>
    <Key>Key</Key>
    <ETag>Etag</ETag>
</PostResponse>

响应消息头

该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。除公共响应消息头之外，还可能返回如下的消息头：

响应消息元素

该响应中将桶的区域信息以消息元素的形式返回，元素的具体含义如下表所示 ：

错误码

请参见调用前必知-错误码-全局错误码。