如果您希望停止向一個Appendable Object繼續追加內容，可以調用SealAppendObject介面。執行該操作後，Object將變為非追加狀態。這允許您通過生命週期（Lifecycle）規則將該Object的儲存類型轉換為冷歸檔（Cold Archive）或深度冷歸檔（Deep Cold Archive）儲存，從而進一步節省儲存成本。未執行此操作前，Appendable Object僅支援轉換為低頻訪問（Infrequent Access）或歸檔（Archive）儲存。
如需調用SealAppendObject介面，請提交工單申請。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
SealAppendObject |
| 停止對某個Appendable Object繼續追加內容，並將其轉為非追加狀態。 |
和其他動作的關係
操作 | 說明 |
對於已執行過SealAppendObject操作的Object，HeadObject會返回x-oss-sealed-time，否則不會返回。 | |
對於已執行過SealAppendObject操作的Object，GetObject會返回x-oss-sealed-time，否則不會返回。 | |
生命週期服務在執行儲存類型轉換操作時，預設不支援將追加上傳產生的Appendable類型的Object轉換為冷Archive Storage或者深度冷Archive Storage類型。但對於已停止寫入的Appendable Object，則允許將其轉為冷Archive Storage類型或深度冷Archive Storage類型。 |
請求文法
POST /ObjectName?seal&position=Position HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Content-Length: 0
Date: GMT Date
Authorization: SignatureValue請求參數
名稱 | 類型 | 是否必選 | 描述 |
seal | 字串 | 是 | 用於發起SealAppendObject操作。 |
position | 字串 | 是 | 指定執行SealAppendObject操作時Object的預期長度。OSS會檢查此長度與Object的實際長度是否一致。如果不一致，請求將失敗並返回PositionNotEqualToLength錯誤。 |
要求標頭
此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。
回應標頭
響應訊息頭 | 類型 | 樣本 | 描述 |
x-oss-sealed-time | 字串 | Wed, 07 May 2025 23:00:00 GMT | Object首次執行SealAppendObject操作的時間（GMT格式）。即使該操作被重複執行，此時間戳記也不會改變。 |
樣本
請求樣本
POST /test.jpg?seal&position=344606 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 07 May 2025 23:00:00 GMT
Content-Length: 0
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250507/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3****響應樣本
HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Appendable
x-oss-storage-class: Standard
x-oss-sealed-time: Wed, 07 May 2025 23:00:00 GMT
Date: Wed, 07 May 2025 23:00:00 GMT
Last-Modified: Mon, 07 Apr 2025 07:32:52 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
AppendSealedObjectNotAllowed | 409 | 對一個非Appendable Object進行SealAppendObject操作。 |
PositionNotEqualToLength | 409 | 請求參數中的position和檔案實際長度不同。 |