Memperpanjang periode retensi objek dalam bucket Object Storage Service (OSS) yang kebijakan retensinya terkunci.
Jika ID kebijakan retensi yang ditentukan dalam permintaan tidak ada, OSS mengembalikan kode status HTTP 404.
Catatan penggunaan
Secara default, kebijakan retensi berbasis waktu berada dalam status InProgress setelah dibuat untuk sebuah bucket. Status ini tetap valid 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 tersebut. Jika kebijakan retensi terkunci, periode perlindungan tidak dapat dipersingkat dan kebijakan tidak dapat dihapus. Periode perlindungan hanya dapat diperpanjang.
Setelah 24 jam kebijakan retensi diaktifkan: Jika kebijakan retensi tidak terkunci, kebijakan menjadi tidak valid.
Jika sebuah bucket berisi objek yang masih dalam periode perlindungan, Anda tidak dapat menghapus bucket atau kebijakan retensinya. Jika bucket dihapus, kebijakan retensinya juga akan dihapus. Hanya pemilik bucket yang dapat menghapus bucket ketika bucket tersebut kosong.
Elemen permintaan
Elemen | Tipe | Diperlukan | Contoh | Deskripsi |
ExtendWormConfiguration | Container | Ya | Tidak tersedia | Node root. Node anak: RetentionPeriodInDays |
wormId | String | Ya | 1666E2CFB2B3418**** | ID kebijakan retensi yang dihasilkan secara otomatis saat operasi InitiateBucketWorm dipanggil. |
RetentionPeriodInDays | Bilangan bulat positif | Ya | 366 | Jumlah hari objek harus disimpan. Nilai valid: 1 hingga 25550. |
Contoh
Permintaan Sampel
POST /?wormId=1666E2CFB2B3418****&wormExtend HTTP/1.1 Date: Thu, 17 Apr 2025 11:18:32 GMT Host: BucketName.oss.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <ExtendWormConfiguration> <RetentionPeriodInDays>366</RetentionPeriodInDays> </ExtendWormConfiguration>Tanggapan Sampel
HTTP/1.1 200 OK Server: AliyunOSS Date: Thu, 15 May 2014 11:18:32 GMT Content-Length: 0 Connection: keep-alive x-oss-request-id: 5C06A3B67B8B5A3DA422299D x-oss-server-time: 122
OSS SDKs
Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut untuk memanggil operasi ExtendBucketWorm:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ExtendBucketWorm, lihat extend-bucket-worm.