Buat kebijakan retensi Write Once Read Many (WORM) untuk sebuah bucket. Kebijakan ini mencegah objek dihapus atau ditimpa selama periode retensi yang ditentukan, yaitu antara 1 hari hingga 70 tahun.
Setelah dikunci, kebijakan retensi tidak dapat dihapus atau diperpendek. Kunci kebijakan hanya setelah Anda memverifikasi periode retensinya.
Prasyarat
Sebelum memulai, pastikan Anda memiliki:
Izin
oss:InitiateBucketWorm. Untuk informasi selengkapnya, lihat Lampirkan kebijakan kustom ke RAM user.Sebuah bucket tanpa Pengendalian versi yang diaktifkan. Pengendalian versi dan kebijakan retensi tidak dapat diterapkan pada bucket yang sama.
Catatan penggunaan
Kebijakan retensi yang baru dibuat berada dalam keadaan tidak terkunci. Jika tidak dikunci dalam waktu 24 jam, kebijakan tersebut menjadi tidak valid.
Setelah kebijakan dikunci, Anda dapat membaca objek dari bucket dan mengunggah objek ke bucket, tetapi tidak dapat menghapus objek atau kebijakan tersebut hingga periode retensi berakhir.
Untuk latar belakang cara kerja kebijakan retensi, lihat Retention policies.
Sintaksis perintah
ossutil api initiate-bucket-worm --bucket <bucket-name> --initiate-worm-configuration <config> [flags]initiate-bucket-worm adalah padanan ossutil dari operasi API InitiateBucketWorm. Untuk daftar flag yang tersedia, lihat Command-line options.Parameter
| Parameter | Tipe | Deskripsi |
|---|---|---|
--bucket | string | Nama bucket. |
--initiate-worm-configuration | string | Konfigurasi kebijakan retensi. Menerima format XML atau JSON (lihat di bawah). |
Format --initiate-worm-configuration
XML:
<InitiateWormConfiguration>
<RetentionPeriodInDays>integer</RetentionPeriodInDays>
</InitiateWormConfiguration>JSON:
{
"RetentionPeriodInDays": integer
}RetentionPeriodInDays menerima nilai integer apa pun dari 1 hari hingga 70 tahun.
Contoh
Contoh berikut membuat kebijakan retensi selama 365 hari untuk examplebucket.
Menggunakan file konfigurasi XML:
<?xml version="1.0" encoding="UTF-8"?>
<InitiateWormConfiguration>
<RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.xmlMenggunakan file konfigurasi JSON:
{
"RetentionPeriodInDays": "365"
}ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.jsonMenggunakan JSON inline:
ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration "{\"RetentionPeriodInDays\":\"365\"}"Langkah selanjutnya
Setelah membuat kebijakan, kunci kebijakan tersebut dalam waktu 24 jam untuk mengaktifkan perlindungan. Untuk petunjuknya, lihat Lock a retention policy.