Panggil operasi InitiateBucketWorm untuk membuat kebijakan retensi.
Catatan penggunaan
Object Storage Service (OSS) mendukung fitur Write Once Read Many (WORM), yang mencegah data dihapus atau dimodifikasi. Anda dapat menetapkan kebijakan retensi berbasis waktu untuk sebuah bucket dengan periode retensi antara 1 hari hingga 70 tahun.
Jika kebijakan retensi berbasis waktu tidak dikunci dalam waktu 24 jam setelah dibuat, kebijakan tersebut secara otomatis menjadi tidak valid. Setelah dikunci, Anda dapat mengunggah dan membaca objek dari bucket tersebut, tetapi tidak dapat menghapus objek maupun kebijakan retensi hingga periode retensi berakhir. Untuk informasi selengkapnya mengenai kebijakan retensi, lihat Kebijakan retensi.
Anda dapat mengonfigurasi Pengendalian versi dan kebijakan retensi pada bucket yang sama, asalkan Pengendalian versi telah diaktifkan pada bucket tersebut.
Elemen permintaan
Name | Tipe | Diperlukan | Deskripsi |
InitiateWormConfiguration | Container | Ya | Node root. Node anak: RetentionPeriodInDays |
RetentionPeriodInDays | Bilangan bulat positif | Ya | Periode retensi untuk objek dalam satuan hari. |
SDK
SDK berikut tersedia untuk API ini:
ossutil
Untuk informasi mengenai perintah ossutil yang sesuai, lihat initiate-bucket-worm.
Contoh
Permintaan contoh
POST /?worm HTTP/1.1 Date: Thu, 17 Apr 2025 11:18:32 GMT Content-Length: 556 Content-Type: application/xml Host: BucketName.oss.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <InitiateWormConfiguration> <RetentionPeriodInDays>365</RetentionPeriodInDays> </InitiateWormConfiguration>Tanggapan contoh
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** x-oss-worm-id: 1666E2CFB2B3418**** Date: Thu, 15 May 2014 11:18:32 GMT