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: //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: //a--12.oos-cn.ctyunapi.cn/1.post
Server: CTYUN

<form action="// 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))。