Panggil operasi SealAppendObject untuk menghentikan penambahan konten ke objek yang dapat ditambahkan. Setelah operasi ini dipanggil, objek tersebut tidak dapat lagi ditambahkan. Hal ini memungkinkan Anda menerapkan aturan lifecycle untuk mengubah kelas penyimpanan objek menjadi Cold Archive atau Deep Cold Archive guna mengurangi biaya penyimpanan. Sebelum menyegel objek yang dapat ditambahkan, Anda hanya dapat mengubah kelas penyimpanannya ke Infrequent Access (IA) atau Archive Storage.
Untuk memanggil operasi SealAppendObject, ajukan tiket guna meminta akses.
Permissions
Secara default, Akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin untuk operasi ini melalui RAM Policy atau Bucket policies.
API | Action | Description |
SealAppendObject |
| Menghentikan penambahan konten ke Objek yang Dapat Ditambahkan dan mengubah statusnya menjadi tidak dapat ditambahkan. |
Relationship with other operations
Operation | Description |
Untuk objek yang telah disegel menggunakan operasi SealAppendObject, HeadObject mengembalikan header x-oss-sealed-time. Jika tidak, header ini tidak dikembalikan. | |
Untuk objek yang telah disegel menggunakan operasi SealAppendObject, GetObject mengembalikan header x-oss-sealed-time. Jika tidak, header ini tidak dikembalikan. | |
Secara default, layanan lifecycle tidak mendukung pengubahan kelas penyimpanan Objek yang Dapat Ditambahkan menjadi Cold Archive atau Deep Cold Archive. Namun, untuk Objek yang Dapat Ditambahkan yang telah disegel, Anda dapat mengubah kelas penyimpanannya menjadi Cold Archive atau Deep Cold Archive. |
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 | Digunakan untuk memulai operasi SealAppendObject. |
position | string | Yes | Menentukan panjang objek yang diharapkan saat Anda memanggil operasi SealAppendObject. OSS memeriksa apakah panjang ini sesuai dengan panjang aktual objek. Jika panjangnya tidak sesuai, permintaan gagal dan error PositionNotEqualToLength dikembalikan. |
Request headers
Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common request headers.
Response headers
Response header | Type | Example | Description |
x-oss-sealed-time | string | Wed, 07 May 2025 23:00:00 GMT | Waktu dalam GMT ketika operasi SealAppendObject pertama kali dilakukan pada objek tersebut. Timestamp ini tidak berubah meskipun operasi tersebut dilakukan kembali. |
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 | Operasi SealAppendObject dilakukan pada objek yang bukan Appendable Object. |
PositionNotEqualToLength | 409 | Nilai parameter position dalam permintaan berbeda dari panjang aktual file. |