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 mengatur 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 tentang kebijakan retensi, lihat Kebijakan retensi.
-
Anda dapat mengonfigurasi Pengendalian versi dan kebijakan retensi pada bucket yang sama, asalkan Pengendalian versi telah diaktifkan untuk bucket tersebut.
Kebijakan retensi tingkat bucket (BucketWorm) dan kebijakan retensi tingkat objek (ObjectWorm) bersifat saling eksklusif. Hanya satu jenis kebijakan retensi yang dapat diaktifkan untuk sebuah bucket.
Elemen permintaan
|
Name |
Type |
Required |
Description |
|
InitiateWormConfiguration |
Container |
Yes |
Node root. Node anak: RetentionPeriodInDays |
|
RetentionPeriodInDays |
Positive integer |
Yes |
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