All Products
Search
Document Center

Object Storage Service:InitiateBucketWorm

Last Updated:Apr 23, 2026

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