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—

表单字段

响应头

除了通用的响应头以外，本操作可以包括以下响应头。

响应结果

请求示例1

使用V4签名：

POST / HTTP/1.1
Content-Type: multipart/form-data; boundary=jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR; charset=UTF-8
Host: a--12.oos-cn.ctyunapi.cn
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.5.7 (Java/1.8.0_351)
Content-Length: 1387

--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="x-amz-algorithm"

AWS4-HMAC-SHA256
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="X-Amz-Credential"

25e67be754a9b2c85870/20240523/cn/s3/aws4_request
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="x-amz-date"

20240523T092508Z
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="key"

test01-post
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="policy"

eyJleHBpcmF0aW9uIjoiMjAyNC0xMi0wMVQxMjowMDowMC4wMDBaIiwiY29uZGl0aW9ucyI6W3siYnVja2V0IjoiYS0tMTIifSx7ImtleSI6InRlc3QwMS1wb3N0In0seyJ4LWFtei1hbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJ4LWFtei1jcmVkZW50aWFsIjoiMjVlNjdiZTc1NGE5YjJjODU4NzAvMjAyNDA1MjMvY24vczMvYXdzNF9yZXF1ZXN0In0seyJ4LWFtei1kYXRlIjoiMjAyNDA1MjNUMDkyNTA4WiJ9XX0=
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="x-amz-signature"

91a935c2c409851f810cff5db53edb24415292edd651292de67432bc672169d7
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="file"; filename="test01-post"
Content-Type: text/plain; charset=UTF-8

hello world!12345!@#$%^&*()_+":[]\?>,.adsf
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR
Content-Disposition: form-data; name="submit"

upload to oos
--jOgLwKAuIgki-MzA2jxfztAlGcp-wO0rfdR--

响应示例1

HTTP/1.1 204 No Content
ETag: "85c974a5ac9c67c64f55dba5d7c803a1"
Date: Thu, 23 May 2024 01:25:08 GMT
x-amz-request-id: c0e2170effd74bba0b7e71807582848a494b513f4143454749
Location: http://a--12.oos-cn.ctyunapi.cn/test01-post
Server: CTYUN

请求示例2

使用V2签名：

POST / HTTP/1.1
Content-Type: multipart/form-data; boundary=Ov8XWNyC3VX8y9lKZ4KPHJvpsN8TfDNqN5l; charset=UTF-8
Host: a--12.oos-cn.ctyunapi.cn
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.5.7 (Java/1.8.0_351)
Accept-Encoding: gzip,deflate
Content-Length: 841

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

25e67be754a9b2c85870
--Ov8XWNyC3VX8y9lKZ4KPHJvpsN8TfDNqN5l
Content-Disposition: form-data; name="key"

1.post
--Ov8XWNyC3VX8y9lKZ4KPHJvpsN8TfDNqN5l
Content-Disposition: form-data; name="policy"

eyJleHBpcmF0aW9uIjoiMjAyNS0xMS0zMVQxMjowMDowMC4wMDBaIiwiY29uZGl0aW9ucyI6W3siYnVja2V0IjoiYS0tMTIifSx7ImtleSI6IjEucG9zdCJ9XX0=
--Ov8XWNyC3VX8y9lKZ4KPHJvpsN8TfDNqN5l
Content-Disposition: form-data; name="signature"

R0y00Fj0FoIFFSuXQvo0i52Gd0Y=
--Ov8XWNyC3VX8y9lKZ4KPHJvpsN8TfDNqN5l
Content-Disposition: form-data; name="file"; filename="1.post"
Content-Type: image/jpeg; charset=UTF-8

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

upload to oos
--Ov8XWNyC3VX8y9lKZ4KPHJvpsN8TfDNqN5l--

响应示例2

HTTP/1.1 204 No Content
ETag: "202cb962ac59075b964b07152d234b70"
Date: Thu, 23 May 2024 02:27:01 GMT
x-amz-request-id: 9d721961d2b14a5a0a7d707f74818389484a543e4042444648
Location: http://a--12.oos-cn.ctyunapi.cn/1.post
Server: CTYUN

<form action="http:// BucketName.oos-cn.ctyunapi.cn /" method="post" enctype="multipart/form-data">
</form>

Post Policy字段的构造

Policy是使用UTF-8和Base64编码的JSON文档，即需要对源码进行转换：先确保源码符合UTF-8编码格式，然后再进行Base-64编码。它指定了请求必须满足的条件并且用于对内容进行身份验证。根据您设计策略文档的方式，您可以对每次上传、每个用户、所有上传或根据其他能够满足您需要的设计来使用它们。

下面是一个简单的Post Policy示例：

1. Policy源码由过期(expiration)和条件(conditions)两部分构成，且符合UTF-8编码格式（如果不符合UTF-8编码格式，需要转换成符合UTF-8编码格式的编码）：

   {
       "expiration": "2007-12-01T12:00:00.000Z",
       "conditions": [
           {
               "bucket": "johnsmith"
           },
           [
               "starts-with",
               "$key",
               "user/eric/"
           ]
       ]
   }

2. 对源码进行Base64编码。

ewogICAgImV4cGlyYXRpb24iOiAiMjAwNy0xMi0wMVQxMjowMDowMC4wMDBaIiwKICAgICJjb25kaXRpb25zIjogWwogICAgICAgIHsKICAgICAgICAgICAgImJ1Y2tldCI6ICJqb2huc21pdGgiCiAgICAgICAgfSwKICAgICAgICBbCiAgICAgICAgICAgICJzdGFydHMtd2l0aCIsCiAgICAgICAgICAgICIka2V5IiwKICAgICAgICAgICAgInVzZXIvZXJpYy8iCiAgICAgICAgXQogICAgXQp9

过期

过期元素采用ISO 8601UTC日期格式来指定策略的过期日期。例如，“2007-12-01T12:00:00.000Z”指定策略在2007年12月1日午夜UTC之后失效。在策略文档中过期字段是必需的。

条件

策略文档中的条件验证上传的文件的内容。表单中指定的每个表单字段（AWSAccessKeyId、signature、X-Amz-signature、file、policy和带x-ignore-前缀的字段名称除外）必须包含在policy条件列表中,两者需要保持一致。如果您有多个具有相同名称的字段，使用逗号进行分隔。例如，如果您有两个名为x- amz-meta-tag的字段，第一个字段的值为Ninja，第二个字段的值为Stallman，您可以将策略文档设置为Ninja,Stallman。

针对扩展的字段执行前缀匹配。例如，如果您将文件名称字段设置为user/betty/${filename}，您的策略可能是["starts-with", "$key", "user/betty/" ]。请勿输入["starts-with", "$key", "user/betty/${filename}"]。

条件匹配

下表介绍条件匹配类型。尽管您必须为您在表单中指定的每个表单字段指定一个条件，您也可以通过为某个表单字段指定多个条件来创建更复杂的匹配条件。

字符串转义

Signature字段的构造步骤

1. 使用UTF-8对policy内容进行编码。

2. 使用Base64对步骤1中的UTF-8字节进行编码,得出签名字符串（StringTosign）。

3. 使用HMAC SHA-1算法，对步骤2中的签名字符串和您的秘密访问密钥进行计算得出签名：HMAC-SHA1(SecretAccessKey,StringToSign)。

4. 使用Base64对SHA-1签名进行编码：Signature=Base64(HMAC-SHA1(SecretAccessKey,StringToSign))。

X-Amz-Signature字段的构造步骤

1. 使用UTF-8对policy内容进行编码。

2. 使用Base64对这些UTF-8字节进行编码，得出签名字符串（StringTosign）。

3. 推算出签名用的密钥（SigningKey）。推算过程：

    

4. 使用HMAC SHA256算法，对步骤2和步骤3中的签名字符串和签名密钥进行计算得出签名。

5. 使用十六进制编码对签名进行编码：X-Amz-Signature=hex(HMAC-SHA256(SigningKey, StringToSign))。