All Products
Search

This Product

    Object Storage Service:PutBucketObjectWormConfiguration

    Document Center

    Object Storage Service:PutBucketObjectWormConfiguration

    Last Updated:Apr 01, 2026

    Gunakan PutBucketObjectWormConfiguration untuk mengaktifkan kebijakan retensi tingkat objek (ObjectWorm) pada bucket dan secara opsional mengonfigurasi kebijakan retensi default. Aksi ini tidak dapat diubah: setelah ObjectWorm diaktifkan untuk bucket, Anda tidak dapat menonaktifkannya.

    Catatan penggunaan

    Penting

    Fitur ini saat ini dalam pratinjau undangan. Untuk menggunakan fitur ini, hubungi technical support untuk mengajukan aktivasi. Fitur ini saat ini hanya didukung di wilayah China (Hangzhou), China (Chengdu), China (Shenzhen), China (Guangzhou), China (Qingdao), China (Beijing), China (Ulanqab), China (Heyuan), China (Hong Kong), Jerman (Frankfurt), Jepang (Tokyo), Korea Selatan (Seoul), Singapura, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Filipina (Manila), Thailand (Bangkok), Arab Saudi (Riyadh), dan UEA (Dubai).

    • Aksi ini tidak dapat diubah. Setelah Anda mengaktifkan kebijakan retensi tingkat objek untuk bucket, Anda tidak dapat menonaktifkan fitur ObjectWorm atau Pengendalian versi-nya.

    • Sebelum memanggil operasi ini, Anda harus mengaktifkan Pengendalian versi untuk bucket tersebut. Jika tidak, operasi akan mengembalikan error.

    • ObjectWorm saling eksklusif dengan kebijakan retensi tingkat bucket (BucketWorm). Jika kebijakan retensi tingkat bucket sudah diaktifkan untuk bucket tersebut, pemanggilan akan gagal dan mengembalikan error.

    • Mengonfigurasi kebijakan retensi default bersifat opsional. Jika Anda mengonfigurasi kebijakan retensi default, sistem akan menerapkannya secara otomatis ke semua objek baru yang diunggah ke bucket. Kebijakan ini tidak berlaku untuk objek yang sudah ada. Untuk menerapkan kebijakan retensi pada objek yang sudah ada, panggil operasi PutObjectRetention.

    • Mengaktifkan ObjectWorm menonaktifkan dukungan untuk unggahan append.

    • Anda harus memberikan izin oss:PutObjectRetention dan oss:GetObjectRetention kepada pengguna agar mereka dapat mengelola kebijakan retensi objek.

    Sintaksis permintaan

    PUT /?objectWorm HTTP/1.1
Content-MD5: ContentMD5
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Header permintaan

    Parameter

    Tipe

    Wajib

    Contoh

    Deskripsi

    Content-MD5

    String

    Ya

    B2M2Y8AsgTpgAmY7PhC****

    Hash MD5 dari badan permintaan yang dikodekan Base64. OSS menggunakan header ini untuk memverifikasi integritas data.

    Content-Length

    Bilangan bulat positif

    Ya

    188

    Panjang badan permintaan dalam byte.

    Elemen permintaan

    Parameter

    Tipe

    Wajib

    Contoh

    Deskripsi

    ObjectWormConfiguration

    Kontainer

    Ya

    N/A

    Kontainer untuk konfigurasi kebijakan retensi tingkat objek bucket.

    Elemen induk: Tidak ada

    Elemen anak: ObjectWormEnabled, Rule

    ObjectWormEnabled

    String

    Ya

    Enabled

    Menentukan apakah akan mengaktifkan kebijakan retensi tingkat objek. Nilai ini harus Enabled.

    Elemen induk: ObjectWormConfiguration

    Rule

    Kontainer

    Tidak

    N/A

    Kontainer untuk kebijakan retensi default tingkat objek bucket.

    Elemen induk: ObjectWormConfiguration

    Elemen anak: DefaultRetention

    DefaultRetention

    Kontainer

    Tidak

    N/A

    Kontainer untuk kebijakan retensi default.

    Elemen induk: Rule

    Elemen anak: Mode, Days, Years

    Mode

    String

    Tidak

    COMPLIANCE

    Mode retensi default untuk kebijakan retensi tingkat objek. Nilai yang valid adalah:

    • COMPLIANCE (mode compliance): Dalam periode retensi, tidak ada pengguna, termasuk root user, yang dapat menghapus atau menimpa versi objek yang dilindungi.

    Elemen induk: DefaultRetention

    Days

    Bilangan bulat positif

    Tidak

    1

    Periode retensi default dalam hari. Nilai yang valid: 1 hingga 36500. Anda harus menentukan salah satu dari Days atau Years, tetapi tidak keduanya.

    Elemen induk: DefaultRetention

    Years

    Bilangan bulat positif

    Tidak

    1

    Periode retensi default ditentukan dalam tahun, dengan rentang nilai valid 1 hingga 100. Anda dapat menetapkan nilai untuk Days atau Years, tetapi tidak keduanya.

    Elemen induk: DefaultRetention

    Contoh

    Contoh 1: Mengaktifkan ObjectWorm dengan kebijakan default

    Contoh berikut menunjukkan cara mengaktifkan ObjectWorm untuk bucket dan mengonfigurasi kebijakan retensi default yang melindungi objek dalam mode compliance selama satu hari.

    • Permintaan contoh

      PUT /?objectWorm HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Length: 188
Content-Type: application/xml
Content-MD5: B2M2Y8AsgTpgAmY7PhC****
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d****

<?xml version="1.0" encoding="UTF-8"?>
<ObjectWormConfiguration>
  <ObjectWormEnabled>Enabled</ObjectWormEnabled>
  <Rule>
    <DefaultRetention>
      <Mode>COMPLIANCE</Mode>
      <Days>1</Days>
    </DefaultRetention>
  </Rule>
</ObjectWormConfiguration>

    • Tanggapan contoh

      HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Length: 0
Server: AliyunOSS

    Contoh 2: Mengaktifkan ObjectWorm tanpa kebijakan default

    Contoh berikut menunjukkan cara mengaktifkan ObjectWorm untuk bucket tanpa mengonfigurasi kebijakan retensi default. Anda dapat memanggil PutObjectRetention nanti untuk mengonfigurasi kebijakan retensi pada objek individual.

    • Permintaan contoh

      PUT /?objectWorm HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Length: 102
Content-Type: application/xml
Content-MD5: C3N3Z9BthUpgBnZ8QiD****
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,Signature=****

<?xml version="1.0" encoding="UTF-8"?>
<ObjectWormConfiguration>
  <ObjectWormEnabled>Enabled</ObjectWormEnabled>
</ObjectWormConfiguration>

    • Tanggapan contoh

      HTTP/1.1 200 OK
x-oss-request-id: 6485B3990232A65C3400****
Date: Thu, 17 Mar 2026 11:20:15 GMT
Content-Length: 0
Server: AliyunOSS

    Kode error

    Kode error

    Kode status HTTP

    Deskripsi

    InvalidBucketState

    409

    Pengendalian versi tidak diaktifkan untuk bucket, sehingga ObjectWorm tidak dapat diaktifkan. Aktifkan Pengendalian versi dan coba lagi.

    BucketWormAlreadyEnabled

    409

    Kebijakan retensi tingkat bucket (BucketWorm) sudah diaktifkan untuk bucket tersebut. Anda tidak dapat mengaktifkan kebijakan retensi tingkat objek (ObjectWorm) secara bersamaan.