Seals an Appendable Object to make it non-appendable. After sealing, you can use lifecycle rules to transition the object to Cold Archive or Deep Cold Archive storage, reducing storage costs. Before sealing, the object can only transition to Infrequent Access (IA) or Archive Storage.
To use this operation, submit a ticket to request access.
Permissions
By default, an Alibaba Cloud account has full permissions. RAM users or RAM roles under an Alibaba Cloud account do not have any permissions by default. The Alibaba Cloud account or account administrator must grant operation permissions through RAM policies or Bucket Policy.
|
API |
Action |
Description |
|
SealAppendObject |
|
Seals an Appendable Object to make it non-appendable. |
Related operations
|
Operation |
Description |
|
Returns the x-oss-sealed-time header for sealed objects. Not returned for unsealed objects. |
|
|
Returns the x-oss-sealed-time header for sealed objects. Not returned for unsealed objects. |
|
|
By default, lifecycle rules cannot transition Appendable Objects to Cold Archive or Deep Cold Archive. Sealing the object removes this restriction. |
Request syntax
POST /ObjectName?seal&position=Position HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Content-Length: 0
Date: GMT Date
Authorization: SignatureValueRequest parameters
|
Name |
Type |
Required |
Description |
|
seal |
string |
Yes |
Initiates the seal operation. |
|
position |
string |
Yes |
Expected object length. OSS verifies this value against the actual object length. If they differ, the request fails with a PositionNotEqualToLength error. |
Request headers
This operation uses only common request headers.
Response headers
|
Response header |
Type |
Example |
Description |
|
x-oss-sealed-time |
string |
Wed, 07 May 2025 23:00:00 GMT |
GMT time when the object was first sealed. Does not change on subsequent seal calls. |
Examples
Request example
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****Response example
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: AliyunOSSError codes
|
Error code |
HTTP status code |
Description |
|
AppendSealedObjectNotAllowed |
409 |
The target object is not an Appendable Object. |
|
PositionNotEqualToLength |
409 |
The position value does not match the actual object length. |