GetBucketWorm - Object Storage Service

Operasi ini digunakan untuk menanyakan kebijakan retensi yang dikonfigurasi pada bucket tertentu.

Catatan

Jika kebijakan retensi dengan ID yang ditentukan dalam permintaan tidak ditemukan, OSS akan mengembalikan kode respons 404.

Catatan Penggunaan

OSS mendukung strategi Write Once Read Many (WORM) yang mencegah objek dihapus atau dimodifikasi selama periode waktu tertentu. Anda dapat mengonfigurasi kebijakan retensi berbasis waktu untuk sebuah bucket, dengan durasi retensi berkisar antara satu hari hingga 70 tahun.

Setelah kebijakan retensi untuk bucket terkunci, Anda hanya dapat membaca objek dari atau mengunggah objek ke bucket tersebut. Kebijakan retensi dan objek di dalam bucket tidak dapat dihapus selama periode retensi. Objek baru dapat dihapus setelah periode retensi berakhir.

Header Permintaan

Permintaan GetBucketWorm hanya mencakup header permintaan umum. Untuk detail lebih lanjut, lihat Header permintaan umum.

Header Respons

Respons terhadap permintaan GetBucketWorm hanya mencakup header respons umum. Untuk informasi lebih lanjut, lihat Header respons umum.

Elemen Respons

Elemen	Tipe	Deskripsi
WormConfiguration	Container	Node root. Node anak: WormId, State, RetentionPeriodInDays, dan CreationDate
WormId	String	ID kebijakan retensi.
State	String	Status kebijakan retensi. Nilai valid: InProgress: menunjukkan bahwa kebijakan retensi berada dalam status InProgress. Secara default, kebijakan retensi berada dalam status InProgress setelah dibuat. Status ini tetap valid selama 24 jam. Locked: menunjukkan bahwa kebijakan retensi berada dalam status Locked.
RetentionPeriodInDays	Bilangan bulat positif	Jumlah hari objek dapat disimpan.
CreationDate	String	Waktu pembuatan kebijakan retensi.

Contoh

Contoh permintaan:

GET /? worm HTTP/1.1
Date: Fri, 16 Oct 2020 11:18:32 GMT
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

Contoh respons:

HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
Date: Fri, 16 Oct 2020 11:18:32 GMT
Content-Type: application/xml
Content-Length: length
<WormConfiguration>
  <WormId>1666E2CFB2B3418****</WormId>
  <State>Locked</State>
  <RetentionPeriodInDays>1</RetentionPeriodInDays>
  <CreationDate>2020-10-15T15:50:32</CreationDate>
</WormConfiguration>

OSS SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi GetBucketWorm:

ossutil

Untuk informasi lebih lanjut tentang perintah ossutil yang sesuai dengan operasi GetBucketWorm, lihat get-bucket-worm.