Bagaimana cara memperpanjang periode retensi objek dalam sebuah bucket? - Object Storage Service

Memperpanjang periode retensi objek dalam sebuah bucket.

Catatan penggunaan

Untuk memperpanjang periode retensi objek dalam sebuah bucket, Anda harus memiliki izin oss:ExtendBucketWorm. Untuk informasi lebih lanjut, lihat Menambahkan kebijakan kustom ke pengguna RAM.
Secara default, kebijakan berbasis waktu berada dalam status InProgress setelah dibuat untuk sebuah bucket. Kebijakan ini tetap dalam status tersebut selama 24 jam dan melindungi data di dalam bucket.
- Dalam jangka waktu 24 jam setelah kebijakan retensi diaktifkan: Jika kebijakan retensi tidak terkunci, pemilik bucket dan pengguna yang berwenang dapat menghapus kebijakan ini. Jika kebijakan retensi terkunci, kebijakan tersebut tidak dapat dihapus dan periode retensi hanya dapat diperpanjang.
- Setelah 24 jam kebijakan retensi diaktifkan: Jika kebijakan retensi tidak terkunci, kebijakan menjadi tidak valid.
Jika sebuah bucket berisi objek yang berada dalam periode perlindungan, Anda tidak dapat menghapus bucket atau kebijakan retensinya. Jika bucket dihapus, kebijakan retensi juga akan dihapus. Hanya pemilik bucket yang dapat menghapus bucket ketika bucket tersebut kosong.

Sintaks perintah

 ossutil api extend-bucket-worm --bucket value --worm-id value --extend-worm-configuration value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--extend-worm-configuration	string	Kontainer yang menyimpan konfigurasi kebijakan retensi.
--worm-id	string	ID kebijakan retensi.

--extend-worm-configuration

Opsi --extend-worm-configuration mendukung format XML dan JSON. Jika nilai opsi tersebut mengandung awalan "file://", ossutil membaca konfigurasi dari file yang ditentukan.

Format XML:

<ExtendWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</ExtendWormConfiguration>

Format JSON:
```
{
  "RetentionPeriodInDays": integer
}
```

Catatan

Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.

Contoh

Perpanjang periode retensi objek yang dilindungi oleh kebijakan retensi "123" menjadi 366 hari.

Gunakan file konfigurasi XML (extend-worm-configuration.xml dalam contoh ini).

<?xml version="1.0" encoding="UTF-8"?>
<ExtendWormConfiguration>
  <RetentionPeriodInDays>366</RetentionPeriodInDays>
</ExtendWormConfiguration>

Contoh perintah:

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.xml

Gunakan file konfigurasi JSON (extend-worm-configuration.json dalam contoh ini).

{
        "RetentionPeriodInDays": "366"
}

Contoh perintah:

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration file://extend-worm-configuration.json

Gunakan parameter JSON di baris perintah.

ossutil api extend-bucket-worm --bucket examplebucket --worm-id 123 --extend-worm-configuration " "{\"RetentionPeriodInDays\":\"366\"}""