Object Storage Service：HTTP 400 錯誤

錯誤原因：跨地區複製配置中指定的目標地區不存在。

解決方案：驗證目標Bucket所在地區的有效性。

錯誤原因：跨域預檢請求中缺少Origin要求標頭。

解決方案：瀏覽器在發送跨域請求前會發送預檢請求（OPTIONS）至OSS，必須包含Origin要求標頭用於標識跨域請求的來源域，確保CORS策略正確匹配。

錯誤原因：跨域預檢請求中缺少Access-Control-Request-Method要求標頭。

解決方案：瀏覽器在發送跨域請求前會發送預檢請求（OPTIONS）至OSS，必須包含Access-Control-Request-Method要求標頭用於標識實際請求所用的HTTP方法，以便OSS驗證該方法是否被允許。

錯誤原因：源Bucket與目標Bucket之間已存在跨地區複製關係。

解決方案：如需配置新的跨地區複製規則，需先刪除現有的跨地區複製規則。

錯誤原因：Bucket配置的CORS規則數量超出限制。

解決方案：Bucket最多允許配置10條CORS規則，超出限制可能導致跨域存取原則過於複雜。建議合并相似的跨網域設定或刪除不必要的規則。詳情請參見PutBucketCors。

錯誤原因：按天匯出資訊清單檔時，Bucket內的檔案數量超出限制。

解決方案：按天匯出資訊清單檔時，Bucket內的檔案數量需小於100億。

當Bucket內檔案數量達到或超過100億時，建議改為按周匯出資訊清單檔。

錯誤原因：上傳的Object超出允許的最大值。

解決方案：採用Post方法上傳檔案時，通過PostPolicy設定表單域的有效值。使用限定條件content-length-range指定允許上傳Object的大小範圍。更多資訊，請參見附錄：Post Policy。

錯誤原因：上傳的Object小於允許的最小值。

解決方案：採用Post方法上傳檔案時，通過PostPolicy設定表單域的有效值。使用限定條件content-length-range指定允許上傳Object的大小範圍。

錯誤原因：Post請求中表單域過大。

解決方案：除file表單域外，其他表單域大小不得超過4KB，更多資訊請參見PostObject錯誤及排查。

錯誤原因：請求的Part已刪除。

解決方案：驗證所有需要的分區是否已成功上傳且未被刪除，可通過CompleteMultipartUpload介面查看已上傳的Part狀態。

錯誤原因：圖片大小超出限制。

解決方案：確保原圖檔案符合以下大小限制：

• 原圖檔案大小不能超過20MB。

• 使用旋轉圖片時原圖的寬或高不能超過4096px。

• 原圖單邊大小不能超過30000px。

錯誤原因：Content-Length參數指定的位元組大小與實際發送的位元組大小不一致。

解決方案：根據實際發送的位元組大小填寫相應的Content-Length參數。

錯誤原因：Post請求中檔案個數無效。Post請求中只能有一個file表單域。

解決方案：確保Post請求中只有一個file表單域。

錯誤原因：

1. Object大小超限：上傳的檔案大小超出當前上傳介面的限制。

2. 防盜鏈配置超限：Referer 白名單和黑名單的配置總大小超過 20 KB。

解決方案：

• 情境一：Object大小超限

  請根據檔案大小調整上傳方式：

  • 簡單/表單/追加上傳：檔案上限 5 GB。

  • 分區上傳：檔案上限 48.8 TB。

• 情境二：防盜鏈配置超限

  請刪除不必要的防盜鏈規則，確保 Referer 白名單和黑名單的總資料大小不超過 20 KB。

錯誤原因：Authorization頭部計算方法中缺失AccessKey ID和Signature參數。

解決方案：在Authorization頭部計算方法中添加參數AccessKey ID，並按照以下籤名樣本完成簽名計算。

假設AccessKey ID為LTAI****************，AccessKey Secret為yourAccessKeySecret，以Python為例介紹計算簽名（Signature）的方法。

import hmac
import hashlib
import base64
import os

accessKeySecret = os.getenv('OSS_ACCESS_KEY_SECRET')
h = hmac.new(accessKeySecret.encode('utf-8'),
             "PUT\neB5************==\ntext/html\nWed, 28 Dec 2022 10:27:41 GMT\nx-oss-meta-author:alice\nx-oss-meta-magic:abracadabra\n/examplebucket/nelson".encode('utf-8'), hashlib.sha1)
signature =  base64.encodebytes(h.digest())
print(signature)

簽名（Signature）計算結果為77Dv****************，結合Authorization頭的結構組成，發送的訊息體如下：

PUT /nelson HTTP/1.0
Authorization:OSS qn6q**************:77Dv****************
Content-Md5: eB5eJF1ptWaXm4bijSPyxw==
Content-Type: text/html
Date: Wed, 28 Dec 2022 10:27:41 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
x-oss-meta-author: alice
x-oss-meta-magic: abracadabra

錯誤原因：Authorization頭部計算方法中涉及參數填寫無效。

解決方案：參考以下說明排查Authorization頭部計算。

• 計算方法

  Authorization = "OSS " + AccessKeyId + ":" + Signature
  Signature = base64(hmac-sha1(AccessKeySecret,
              VERB + "\n"
              + Content-MD5 + "\n" 
              + Content-Type + "\n" 
              + Date + "\n" 
              + CanonicalizedOSSHeaders
              + CanonicalizedResource))

• 參數說明

  參數	類型	是否必選	樣本值	說明
  AccessKeyId	字串	是	LTAI****************	密鑰中的AccessKey ID。
  AccessKeySecret	字串	是	yourAccessKeySecret	密鑰中的AccessKey Secret。
  VERB	枚舉值	是	PUT	HTTP請求的Method，包含PUT、GET、POST、HEAD、DELETE、OPTIONS等。
  \n	字串	否	\n	分行符號。
  Content-MD5	字串	否	eB5eJF1ptWaXm4bijSPyxw==	請求內容資料的MD5值，對訊息內容（不包括頭部）計算MD5值獲得128位元位元字，對該數字進行base64編碼得出。更多資訊，請參見RFC2616 Content-MD5。 該要求標頭可用於訊息合法性的檢查（訊息內容是否與發送時一致），也可以為空白。 關於Content-MD5的計算方法，請參見Content-MD5的計算方法。
  Content-Type	字串	否	application/octet-stream	請求內容的類型，也可以為空白。
  Date	字串	是	Sun, 22 Nov 2015 08:16:38 GMT	重要 此次操作的時間，Date必須為GMT格式且不可為空。 如果請求中的Date時間和OSS伺服器的目前時間差15分鐘以上，OSS伺服器將拒絕該請求，並返回HTTP 403錯誤。
  CanonicalizedOSSHeaders	字串	否	x-oss-meta-a:a\nx-oss-meta-b:b\nx-oss-meta-c:c\n	以x-oss-為首碼的HTTP Header的字典序排列，可以為空白。 如果設定CanonicalizedOSSHeaders為空白，則無需在最後添加分隔字元\n。 如果只有一個CanonicalizedOSSHeaders，則需要在最後添加分隔字元\n，例如x-oss-meta-a\n。 如果有多個CanonicalizedOSSHeaders，則需要在每一個CanonicalizedOSSHeaders之後添加分隔字元\n，例如x-oss-meta-a:a\nx-oss-meta-b:b\nx-oss-meta-c:c\n。 關於CanonicalizedOSSHeaders的構建方法，請參見構建CanonicalizedOSSHeaders的方法。
  CanonicalizedResource	字串	是	/examplebucket/	使用者想要訪問的OSS資源，不可為空。 關於CanonicalizedResource的構建方法，請參見構建CanonicalizedOSSHeaders的方法。

• 簽名樣本

  請求	簽名字串計算公式	簽名字串
  PUT /nelson HTTP/1.0 Content-MD5: eB5eJF1ptWaXm4bijSPyxw== Content-Type: text/html Date: Wed, 28 Dec 2022 10:27:41 GMT Host: examplebucket.oss-cn-hangzhou.aliyuncs.com x-oss-meta-author: alice x-oss-meta-magic: abracadabra	Signature = base64(hmac-sha1(AccessKeySecret,VERB + "\n" + Content-MD5 + "\n"+ Content-Type + "\n" + Date + "\n" + CanonicalizedOSSHeaders+ CanonicalizedResource))	PUT\n eB5eJF1ptWaXm4bijSPyxw==\n text/html\n Wed, 28 Dec 2022 10:27:41 GMT\n x-oss-meta-magic:abracadabra\nx-oss-meta-author:alice\n/examplebucket/nelson

  假設AccessKey ID為LTAI****************，AccessKey Secret為yourAccessKeySecret，以Python為例介紹計算簽名（Signature）的方法。

  import hmac
  import hashlib
  import base64
  import os
  
  accessKeySecret = os.getenv('OSS_ACCESS_KEY_SECRET')
  h = hmac.new(accessKeySecret.encode('utf-8'),
               "PUT\neB5************==\ntext/html\nWed, 28 Dec 2022 10:27:41 GMT\nx-oss-meta-author:alice\nx-oss-meta-magic:abracadabra\n/examplebucket/nelson".encode('utf-8'), hashlib.sha1)
  signature =  base64.encodebytes(h.digest())
  print(signature)

  簽名（Signature）計算結果為77Dv****************，結合Authorization頭的結構組成，發送的訊息體如下：

  PUT /nelson HTTP/1.0
  Authorization:OSS qn6q**************:77Dv****************
  Content-Md5: eB5eJF1ptWaXm4bijSPyxw==
  Content-Type: text/html
  Date: Wed, 28 Dec 2022 10:27:41 GMT
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  x-oss-meta-author: alice
  x-oss-meta-magic: abracadabra

錯誤原因：Authorization頭部計算方法中涉及參數填寫錯誤。

解決方案：參考下表參數說明完成Authorization頭部計算。

錯誤原因：Authorization頭部計算方法中相關參數取值為空白。

解決方案：參考下表參數說明完成Authorization頭部計算。

錯誤原因：時間參數無效。

解決方案：時間格式需遵從RFC 1123標準，例如Sun, 06 Nov 1994 08:49:37 GMT。

錯誤原因：Host無效。

解決方案：Host包含Bucket網域名稱以及IP地址兩種。Bucket網域名稱格式為BucketName.Endpoint，例如examplebucket.oss-cn-hangzhou.aliyuncs.com。如Host為IP地址，需確保IP地址有效。

錯誤原因：拷貝檔案時，沒有指定源Bucket和源Object。

解決方案：拷貝檔案時，需按照/sourcebucket/sourcekey的格式指定拷貝的源地址參數x-oss-copy-source。例如源Bucket為examplebucket，源Object為exampleobject，則拷貝檔案時x-oss-copy-source應指定為/examplebucket/exampleobject。

錯誤原因：請求URL和請求Header中同時包含了callback參數。

解決方案：僅允許在請求URL或請求Header中包含callback參數。

錯誤原因：請求URL和請求Header中同時包含了callback var參數。

解決方案：僅允許在請求URL或請求Header中包含callback var參數。

錯誤原因

同一個請求中，在請求Header中存在用於簽名的Authorization欄位，且在請求URI中存在用於簽名的OSSAccessKeyId、Expires和Signature欄位。樣本如下：

PUT /example_file?OSSAccessKeyId=LTAI****************&Expires=1141889120&Signature=vjbyPxybdZaNmGa%2ByT272YEAiv**** HTTP/1.0
Authorization:OSS qn6q**************:77Dv****************
Content-Md5: eB5eJF1ptWaXm4bijSPyxw==
Content-Type: text/html
Date: Tue, 20 Dec 2022 08:48:18 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com

解決方案

同一個請求中，僅使用Header簽名或僅使用URI簽名。僅使用Header簽名樣本如下：

PUT /example_file HTTP/1.0
Authorization:OSS qn6q**************:77Dv****************
Content-Md5: eB5eJF1ptWaXm4bijSPyxw==
Content-Type: text/html
Date: Tue, 20 Dec 2022 08:48:18 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com

僅使用URI簽名樣本如下：

PUT /example_file?OSSAccessKeyId=LTAI****************&Expires=1141889120&Signature=vjby******** HTTP/1.0
Content-Md5: eB5eJF1ptWaXm4bijSPyxw==
Content-Type: text/html
Date: Tue, 20 Dec 2022 08:48:18 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com

錯誤原因：參數格式不符合要求。

解決方案：請參見API概覽中相應的API，填寫正確的參數格式。

錯誤原因：時間參數無效，Unix時間戳記晚於目前時間。

解決方案：Unix時間戳記必須早於目前時間。

錯誤原因：時間參數無效，Unix時間戳記小於0。

解決方案：Unix時間戳記必須大於0。

錯誤原因：指定的Object版本ID無效。

解決方案：通過GetBucketVersions (ListObjectVersions)介面確認Bucket是否已開啟版本控制，以及Object填寫的版本ID是否正確。

錯誤原因：當SSEAlgorithm取值為AES256時，填寫了KMSMasterKeyID。

解決方案：僅當SSEAlgorithm取值為KMS且使用指定的祕密金鑰加密時，需填寫KMSMasterKeyID。

錯誤原因：使用者無操作許可權。

解決方案：只有Bucket擁有者或者授權的RAM使用者才能為Bucket設定加密規則。詳情請參見PutBucketEncryption。

錯誤原因：指定的Bucket儲存類型不存在。

解決方案：OSS僅支援Standard（標準儲存）、IA（低頻訪問儲存）、Archive（Archive Storage）、ColdArchive（冷Archive Storage）、DeepColdArchive（深度冷Archive Storage）多種儲存類型。詳情請參見PutBucket。

錯誤原因：Authorization頭中的Date無效。

解決方案：Date表示此次操作的時間，且必須為GMT格式，例如Sun, 22 Nov 2015 08:16:38 GMT。

錯誤原因：Post請求的Body總長度超過5 GB。

解決方案：Post請求的Body總長度不允許超過5 GB。詳情請參見PostObject。

錯誤原因：Post請求Header中缺少OSSAccessKeyId表單域。

解決方案：當Bucket為非public-read-write或者提供了Policy（或Signature）表單域時，必須提供OSSAccessKeyId表單域。

錯誤原因：Post請求Header中缺少簽名資訊。

解決方案：當Bucket為非public-read-write或者提供了OSSAccessKeyId（或Policy）表單域時，必須提供Signature表單域。計算Signature的具體流程如下：

1. 建立一個UTF-8編碼的Policy。

2. 將Policy進行Base64編碼，其值即為Policy表單域填入的值，將該值作為將要簽名的字串。

3. 使用AccessKeySecret對要簽名的字串進行簽名，簽名方法為Signature = base64(hmac-sha1(base64(policy), AccessKeySecret))。

錯誤原因：OSS無法向內網IP地址發送callback請求。

解決方案：使用公網地址發送callback請求。

錯誤原因：filename欄位的下一行包含了自訂參數。

解決方案：filename欄位的下一行必須為規範的Content-Type參數。如下圖所示：

錯誤原因：Post請求中未指定key表單域，或者指定的key表單域順序有誤。

解決方案：在Post請求中指定key表單域，且key表單域須排在file表單域之前。詳情請參見PostObject。

錯誤原因：POST請求表單中包含無效參數，或者參數格式不正確。

解決方案：請參見PostObject填寫規範的參數。

錯誤原因：未填寫callbackBody參數。

解決方案：Callback參數必須為經過Base64編碼的JSON字串，且必須指定請求回調的伺服器URL（callbackUrl）以及回調的內容（callbackBody）。

錯誤原因：callbackBody參數無效，無法進行JSON解析。

解決方案：callbackBody表示發起回調時請求Body的值，例如key=$(object)&etag=$(etag)&my_var=$(x:my_var)。請參見Callback進行排查。

錯誤原因：callbackBodyType參數無效，無法進行JSON解析。

解決方案：callbackBodyType表示發起回調請求的Content-Type，支援application/x-www-form-urlencoded和application/json。

錯誤原因：Callback參數未經過Base64編碼。

解決方案：Callback參數必須為經過Base64編碼的JSON字串，且必須指定請求回調的伺服器URL以及回調的內容。詳情請參見Callback。

錯誤原因：Callback參數不是JSON格式。

解決方案：Callback參數必須為經過Base64編碼的JSON字串。樣本如下：

{
"callbackUrl":"121.101.XX.XX/test.php",
"callbackHost":"oss-cn-hangzhou.aliyuncs.com",
"callbackBody":"{\"mimeType\":${mimeType},\"size\":${size}}",
"callbackBodyType":"application/json"
}

錯誤原因：callbackHost參數無效，無法進行JSON解析。

解決方案：callbackHost表示發起回調請求的Host頭，例如oss-cn-hangzhou.aliyuncs.com。如果未配置callbackHost，則解析callbackUrl中的URL，並將URL中解析到的Host填充到callbackHost中。

錯誤原因：簽名版本不支援。

解決方案：確認當前簽名為1.0或2.0版本。

錯誤原因：Callback參數未指定請求回調的伺服器URL（callbackUrl）。

解決方案：Callback參數必須為經過Base64編碼的JSON字串，且必須指定請求回調的伺服器URL以及回調的內容。

錯誤原因：callback-var參數不是JSON格式。

解決方案：callback-var用於配置自訂參數，自訂參數格式為Key-Value對，Key必須以x:開頭且必須為小寫格式。假設需要設定的Key分別為x:var1和x:var2，對應的值分別為value1和value2，則JSON格式如下：

{
"x:var1":"value1",
"x:var2":"value2"
}

錯誤原因：使用者自訂Header的格式錯誤。

解決方案：使用者自訂Header格式為x-oss-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2)....。其中key1、key2等為自訂的Header，value1、value2為自訂Header對應的值，Base64_encode表示對自訂Header的值進行Base64編碼。例如自訂Header為myheader1和myheader2，其值分別為myvalue1、myvalue2，則自訂請求Header應為x-oss-persistent-headers:myheader1:bXl2YWx1ZTE=,myheader2:bXl2YWx1ZTI=。

錯誤原因：標籤中Key和Value值未進行URL編碼，且Key值重複。

解決方案：對象標籤使用一組索引值對（Key-Value）標記對象，對象標籤規則如下：

• 單個Object最多可設定10個標籤，Key不可重複。

• 每個Key長度不超過128字元，每個Value長度不超過256字元。

• Key和Value區分大小寫。

• 標籤合法字元集包括大小寫字母、數字、空格和以下符號：+‑=._:/ 通過HTTP Header的方式設定標籤且標籤中包含任一字元時，需要對標籤的Key和Value做URL編碼。

錯誤原因：使用者自訂Header包含非法字元。

解決方案：OSS遵循RFC7230規範，根據RFC7230規範判斷HTTP Header是否包含非法字元。

錯誤原因：使用者自訂Header與HTTP標準頭衝突。

解決方案：使用者自訂Header中不能指定HTTP標準頭，例如Host、Content-MD5、Origin或Range等。

錯誤原因：使用者自訂Header中的Value值包含了斷行符號符\r或分行符號\n。

解決方案：刪除使用者自訂Header中Value值包含的斷行符號符\r和分行符號\n。

錯誤原因：使用者自訂Header與要求標頭中的Header重名時，兩者的Value值不一致。

解決方案：使用者自訂Header與要求標頭中的Header重名時，兩者的Value值需保持一致。

錯誤原因：使用者自訂Header中的Value值不合法。

解決方案：對自訂Header中Value值包含的中文等特殊字元進行UTF-8編碼。

錯誤原因：callback參數的Base64編碼總長度超過了5 KB。

解決方案：callback參數的Base64編碼總長度最大為5 KB。

錯誤原因：callback var參數的Base64編碼總長度超過了5 KB。

解決方案：callback var參數的Base64編碼總長度最大為5 KB。

錯誤原因：請求的callbackurl個數超過5個。

解決方案：OSS支援同時配置最多5個URL，每個URL之間以分號（;）分隔。

錯誤原因：<VersioningConfiguration>欄位中未指定Bucket的版本控制狀態。

解決方案：在<VersioningConfiguration>欄位中指定Bucket的版本控制狀態。樣本如下：

PUT /?versioning HTTP/1.1
Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 02:20:12 GMT
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Enabled</Status>
<VersioningConfiguration>

錯誤原因：Authorization頭部計算方法中出現未知參數。

解決方案：參考下表參數說明完成Authorization頭部計算。

錯誤原因：未指定VersionId欄位。

解決方案：在VersionId欄位中填寫Object的版本ID。詳情請參見ListObjectVersions（GetBucketVersions）。

錯誤原因：單連結限速取值無效。

解決方案：單連結限速取值範圍為819200~838860800，即100 KB/s~100 MB/s。

錯誤原因：請求URL和請求Header中同時包含了單連結限速參數x-oss-traffic-limit。

解決方案：僅允許在請求URL或請求Header中包含單連結限速參數x-oss-traffic-limit。

錯誤原因：Bucket命名不符合規範。

解決方案：檢查並確保Bucket命名符合規範。Bucket命名規範如下：

• 只包含小寫字母、數字和短劃線（-）。

• 以小寫字母或者數字開頭和結尾。

• 長度必須在3~63字元之間。

錯誤原因：跨地區複製的源Bucket和目標Bucket的版本控制狀態不一致。

解決方案：跨地區複製的源Bucket和目標Bucket需同時開啟或關閉版本控制。

錯誤原因：Channel名稱欄位缺失。

解決方案：按照命名規範填寫Channel名稱。

• 使用UTF-8編碼。

• 長度必須在1~64字元之間。

• 不能包含正斜線（/）或者反斜線（\）。

錯誤原因：Channel名稱包含了斜線。

解決方案：確保Channel名稱不能包含正斜線（/）或者反斜線（\）。

錯誤原因：Channel名稱編碼方式錯誤。

解決方案：Channel名稱需使用UTF-8編碼。

錯誤原因：Channel名稱長度超出限制。

解決方案：確保Channel名稱長度必須在1~64字元之間。

錯誤原因：本地計算的crc64值與伺服器返回的crc64值不一致。

解決方案：請參見通過crc64校正資料轉送的完整性進行排查。

錯誤原因：指定的Object密碼編譯演算法無效。

解決方案：當Object的加密方式為KMS時，密碼編譯演算法僅支援SM4。更多資訊，請參見服務端加密。

錯誤原因：上傳的Content-MD5要求標頭與OSS計算訊息體的Content-MD5不一致。

解決方案：請參見Content-MD5的計算方法進行排查。

錯誤原因：x-oss-server-side-encryption參數指定的值無效。

解決方案：x-oss-server-side-encryption有效值為AES256、KMS或SM4。有關服務端加密方式的更多資訊，請參見PutObject。

錯誤原因：不支援對經過用戶端加密的源檔案中調用UploadPartCopy介面。

解決方案：僅支援從未經用戶端加密的源檔案中調用UploadPartCopy介面，實現從一個已存在的Object中拷貝資料來上傳一個Part。詳情請參見UploadPartCopy。

錯誤原因：用戶端加密缺少必要參數。

解決方案：確保已填寫以下各項必選參數。

錯誤原因：用戶端加密中繼資料中輸入的檔案總大小或分區大小不合法。

解決方案：通過用戶端加密Multipart檔案時，需要在init_multipart時傳入整個大檔案的總大小（x-oss-meta-client-side-encryption-data-size）以及分區大小（x-oss-meta-client-side-encryption-part-size），且分區大小必須是16的整數倍。詳情請參見用戶端加密（Java SDK V1）。

錯誤原因：用戶端加密配置的分區加密資訊與初始化分區上傳中設定的加密資訊不一致。

解決方案：確保用戶端配置的分區加密資訊與初始化分區上傳中設定的加密資訊一致。詳情請參見用戶端加密（Java SDK V1）。

錯誤原因：實際上傳的分區數量和初始化分區上傳指定的分區數量不一致。

解決方案：確保指定的分區數量與實際上傳的分區數量一致。

錯誤原因：實際上傳的所有分區總大小與初始化分區上傳指定的分區總大小不一致。

解決方案：上傳最後一個分區後，確保實際上傳的所有分區總大小與初始化分區上傳指定的分區總大小一致。詳情請參見CompleteMultipartUpload。

錯誤原因：通過CopyObject介面修改用戶端加密中繼資料。

解決方案：調用用戶端加密上傳檔案後，加密中繼資料會被保護，無法通過CopyObject修改Object meta資訊。詳情請參見CopyObject。

錯誤原因：分區ID大於總分區數（PartNumber）。

解決方案：確保分區ID等於或者小於總分區數。詳情請參見UploadPart。

錯誤原因：用戶端加密中繼資料中輸入的Part數量超出限制。

解決方案：每個Object最多支援切分為10000個Part。

錯誤原因：實際上傳的每個分區大小與初始化分區上傳指定的每個分區大小不一致。

解決方案：除最後一個分區外，其他分區大小均要求與初始化分區上傳指定的每個分區大小一致。詳情請參見UploadPart。

錯誤原因：Host參數錯誤。

解決方案：使用標準訪問網域名稱。有關訪問網域名稱和資料中心的更多資訊，請參見訪問網域名稱和資料中心。

錯誤原因：Object名稱超出長度限制。

解決方案：確保Object名稱長度必須在1~1023字元之間。

錯誤原因：未指定Object名稱。

解決方案：按照Object命名規範指定Object名稱。

錯誤原因：指定的Object名稱無效。

解決方案：檢查並確保Object命名符合規範。Object命名規範如下：

• 使用UTF-8編碼。

• 長度必須在1~1023字元之間。

• 不是以正斜線（/）或者反斜線（\）開頭。

錯誤原因：指定的CMK ID無效。

解決方案：當Object加密方式為KMS且使用指定的祕密金鑰加密時，需輸入CMK ID。CMK ID樣本值為9468da86-3509-4f8d-a61e-6eab1eac****。

錯誤原因：PartNumber或ETag錯誤導致CompleteMultipartUpload提交的Part無效。

解決方案：服務端在調用CompleteMultipartUpload介面時會對PartNumber和ETag做校正。

• PartNumber取值為1~10000。PartNumber可以不連續，但必須升序排列。例如第一個Part的PartNumber是1，第二個Part的PartNumber可以是5。

• 通過CompleteMultipartUpload請求建立的Object，ETag值是其內容的UUID。ETag值可以用於檢查Object內容是否發生變化。

錯誤原因：無效的PartNumber。

解決方案：確保PartNumber取值為1~10000，更多資訊請參見CompleteMultipartUpload。

錯誤原因：CompleteMultipartUpload提交的Part未按照partNumber升序排列。

解決方案：CompleteMultipartUpload提交的Part需按照partNumber升序排列。例如第一個Part的PartNumber是1，第二個Part的PartNumber可以是5，更多資訊請參見CompleteMultipartUpload。

錯誤原因：請求中的Policy格式錯誤。

解決方案：檢查Policy中是否缺少,或]。

錯誤原因：請求中的Policy格式錯誤。

解決方案：檢查Policy格式，是否缺失"，逸出字元前是否有\。

錯誤原因：請求Policy中沒有包含conditions。

解決方案：請求Policy中必須包含至少一項conditions。

錯誤原因：儲存空間標籤的Key或Value不合法。

解決方案：檢查並確儲存儲空間標籤命名符合規範，標籤規範如下：

• Key和Value必須為UTF-8編碼。

• Key最大長度為64字元，不能以http://、https://、Aliyun為首碼，且不可為空。

• Value最大長度為128字元，可以為空白。

錯誤原因：對象標籤中配置的Key不合法。

解決方案：對象標籤使用一組索引值對（Key-Value）標記對象，對象標籤規則如下：

• 每個Key長度不超過128字元，每個Value長度不超過256字元。

• Key和Value區分大小寫。

• 標籤合法字元集包括大小寫字母、數字、空格和以下符號：+‑=._:/ 通過HTTP Header的方式設定標籤且標籤中包含任一字元時，需要對標籤的Key和Value做URL編碼。

錯誤原因：跨地區複製的目標Bucket無效。

解決方案：調用GetBucketReplicationLocation擷取可複製到的目標儲存空間（Bucket）所在的地區。

錯誤原因：存放日誌的目標Bucket不存在。

解決方案：更換為有效目標Bucket。

錯誤原因：目標地區不存在此Bucket。

解決方案：檢查Bucket所在地區。

錯誤原因：Object類型為軟連結，且軟連結指向的目標Object類型仍為軟連結。

解決方案：確保軟連結指向的目標Object不是軟連結。

錯誤原因：合規保留原則無效。

解決方案：通過InitiateBucketWorm介面建立合規保留原則樣本如下：

POST /?worm HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Length：556
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

<InitiateWormConfiguration>
  <RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>

錯誤原因：參數不符合XML格式。

解決方案：檢查參數是否符合XML格式。

錯誤原因：單個Bucket配置的清單規則已達到最大值1000條。

解決方案：如需調整清單規則上限，請提交工單。

錯誤原因：使用KMS加密方式進行服務端加密時，未開通KMS服務。

解決方案：使用KMS加密方式進行服務端加密前，需預先開通KMS服務。詳情請參見開通Key Management Service。

錯誤原因：PostObject請求中表單域格式不符合要求。

解決方案：遵循表單域格式要求。表單域格式如下：

Content-Disposition: form-data;
        name="{key}"\r\n\r\n{value}\r\n--{boundary}

PostObject請求樣本如下：

POST / HTTP/1.1
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; zh-CN; rv:1.9.2.6)
Content-Type: multipart/form-data; boundary=9431149156168
Host: xxxx-hz.oss-cn-hangzhou.aliyuncs.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Content-Length: 5052
--9431149156168
Content-Disposition: form-data; name="key"
test-key
--9431149156168
Content-Disposition: form-data; name="Content-Disposition"
attachment;filename=D:\img\example.png
--9431149156168
Content-Disposition: form-data; name="OSSAccessKeyId"
2NeL********j2Eb

要求如下：

• Header必須包含Content-Type: multipart/form-data; boundary={boundary}。

• Header和Body之間由\r\n--{boundary}分割。\r\n顯示為換行。

• 表單網域名稱稱大小寫敏感，如policy、key、file、OSSAccessKeyId、OSSAccessKeyId、Content-Disposition。

• 表單域file必須為最後一個表單域。

• Bucket為public-read-write時，可以不指定表單域OSSAccessKeyId、policy、Signature。如果指定了其中一個，則無論Bucket是否為public-read-write，都必須指定另外兩個。

如果您還有疑問，請參見範例程式碼：

• C#

• Java

• JavaScript

錯誤原因：請求中的XML格式非法。

解決方案：根據具體請求進行錯誤排查。各請求的詳細資料如下：

• DeleteMultipleObjects

• CompleteMultipartUpload

• PutBucketLogging

• PutBucketWebsite

• PutBucketLifecycle

• PutBucketReferer

• PutBucketCORS

錯誤原因：上傳的檔案過大。通過Post方法上傳的檔案不能超過5 GB。

解決方案：參見PostObject錯誤及排查。

錯誤原因：缺少AccessKey ID。

解決方案：填寫正確的AccessKey ID。

錯誤原因：封裝API時缺少必選參數。

解決方案：參考API概覽中相應的API文檔，補充所有必選參數。

錯誤原因：源Bucket所在的資料中心沒有與之配對的可實施跨地區複製的資料中心。

解決方案：參考GetBucketReplicationLocation擷取可用的複製目標地區。

錯誤原因：請求的Bucket沒有配置跨地區複製規則。

解決方案：參考PutBucketReplication為Bucket配置跨地區複製規則。

錯誤原因：封裝API時傳遞了錯誤的或者不支援的參數。

解決方案：參考API概覽中相應的API文檔，使用正確且支援的參數格式。

錯誤原因：操作的Object不是軟連結類型。

解決方案：確保PutSymlink或GetSymlink操作僅作用於軟連結類型的Object。

錯誤原因：該資源不支援此類操作。可能的情境如下：

• 將Appendable類型的Object或者軟連結（symlink）轉換為冷歸檔或者深度冷Archive Storage類型。

• 通過RestoreObject介面解凍非歸檔、冷歸檔或者深度冷Archive Storage類型Object。

解決方案：

• 調用PutObject介面上傳同名Object，將Appendable類型Object覆寫為Normal類型Object，然後將該Object轉換為冷歸檔或者深度冷Archive Storage類型。

• 調用RestoreObject介面解凍檔案時，確保待解凍檔案為歸檔、冷歸檔或者深度冷Archive Storage類型。

有關各類資源支援的操作類型，請參見API概覽。

錯誤原因：標籤中的Key已存在。

解決方案：調用GetBucketTags擷取儲存空間已配置的標籤資訊，然後參考PutBucketTags配置新的標籤。

錯誤原因：Post操作提交表單編碼不是multipart/form-data類型。

解決方案：Post操作提交表單編碼必須為multipart/form-data，即Header中Content-Type為multipart/form-data;boundary=xxxxxx形式，boundary為邊界字串。詳情請參見PostObject。

錯誤原因：因網路環境或網路設定等引起的網路逾時。

解決方案：參考網路逾時處理進行排查。

錯誤原因：同一阿里雲帳號在同一地區內建立的Bucket數量已達到最大值100個。

解決方案：

• Bucket容量沒有限制，可以在Bucket中建立新目錄區分儲存的內容。關於如何建立目錄，請參見建立目錄。

• 刪除不再需要的Bucket。關於如何刪除Bucket，請參見刪除儲存空間。

  重要

  Bucket刪除後不可恢複，請謹慎操作。

• 如需調整Bucket數量上限，請提交工單申請。

錯誤原因：單個Bucket可綁定的網域名稱數量已達到最大值100個。

解決方案：如需調整Bucket網域名稱數量上限，請提交工單。

錯誤原因：跨地區複製規則中配置的對象標籤個數超出限制。

解決方案：同步與指定標籤匹配的Object到目標Bucket，最多可添加10個標籤。

錯誤原因：與Bucket關聯的跨地區複製規則個數已達到100條。

解決方案：單個Bucket支援配置100條跨地區複製規則。如果業務需求超出數量限制，請提交工單。

錯誤原因：與Bucket關聯的跨地區複製規則個數已達到100條。

解決方案：單個Bucket支援配置100條跨地區複製規則。如果業務需求超出數量限制，請提交工單。

錯誤原因：圖片操作次數過多。

解決方案：減少圖片操作次數，將操作次數控制在系統限制範圍內。

錯誤原因：跨地區複製規則中配置的首碼數量超出限制。

解決方案：進行跨地區複製時，將指定首碼的Object同步到目標Bucket，最多可以添加10個首碼。

錯誤原因：單個Bucket配置的跨地區複製規則數量超出限制。

解決方案：單個Bucket僅允許配置一條跨地區複製規則。

錯誤原因：Bucket配置的標籤數量超出限制。

解決方案：Bucket允許配置最多20個標籤。詳情請參見PutBucketTags。

錯誤原因：刪除Object時未指定Object名稱。

解決方案：刪除Object時需指定Object名稱。詳情請參見DeleteMultipleObjects。

錯誤原因：按周匯出資訊清單檔時，Bucket內的檔案數量超出限制。

解決方案：按周匯出資訊清單檔時，Bucket內的檔案數量需少於500億。

當Bucket內的檔案數量大於等於500億時：

• 按首碼匹配分批匯出。

• 通過提交工單申請提升匯出Bucket檔案數量的限制。