全部产品
Search

搜索本产品

    Object Storage Service：Membuat kebijakan retensi

    文档中心

    Object Storage Service：Membuat kebijakan retensi

    更新时间：Jul 02, 2025

    Membuat kebijakan retensi.

    Catatan penggunaan

    • Untuk membuat kebijakan retensi, Anda memerlukan izin oss:InitiateBucketWorm. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

    • Object Storage Service (OSS) mendukung fitur Write Once Read Many (WORM) yang mencegah objek dihapus atau ditimpa selama periode waktu tertentu. Anda dapat mengonfigurasi kebijakan retensi berbasis waktu untuk bucket dengan periode perlindungan mulai dari 1 hari hingga 70 tahun.

    • Jika kebijakan retensi tidak dikunci dalam waktu 24 jam setelah dibuat, kebijakan tersebut menjadi tidak valid. Setelah kebijakan retensi untuk suatu bucket dikunci, Anda hanya dapat membaca objek dari atau mengunggah objek ke bucket tersebut. Anda tidak dapat menghapus kebijakan retensi atau objek dalam bucket selama periode retensi. Objek hanya dapat dihapus setelah periode retensi berakhir. Untuk informasi lebih lanjut tentang kebijakan retensi, lihat Kebijakan Retensi.

    • Anda tidak dapat mengaktifkan penomoran versi dan mengonfigurasi kebijakan retensi untuk bucket secara bersamaan. Jika penomoran versi diaktifkan untuk bucket, Anda tidak dapat mengonfigurasi kebijakan retensi untuk bucket tersebut. Untuk informasi lebih lanjut tentang penomoran versi, lihat Ikhtisar.

    Sintaks perintah

    ossutil api initiate-bucket-worm --bucket value --initiate-worm-configuration value [flags]

    Parameter

    Tipe

    Deskripsi

    --bucket

    string

    Nama bucket.

    --initiate-worm-configuration

    string

    Badan permintaan.

    Catatan

    Perintah initiate-bucket-worm setara dengan operasi InitiateBucketWorm. Untuk informasi lebih lanjut tentang operasi API, lihat InitiateBucketWorm.

    --initiate-worm-configuration

    Opsi --initiate-worm-configuration mendukung format XML dan JSON.

    • Format XML:

      <InitiateWormConfiguration>
  <RetentionPeriodInDays>integer</RetentionPeriodInDays>
</InitiateWormConfiguration>

    • Format JSON:

      {
  "RetentionPeriodInDays": integer
}
    Catatan

    Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.

    Contoh

    Buat kebijakan retensi untuk bucket examplebucket.

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

      <?xml version="1.0" encoding="UTF-8"?>
<InitiateWormConfiguration>
  <RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>

      Contoh perintah:

      ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.xml

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

      {
        "RetentionPeriodInDays": "365"
}

      Contoh perintah:

      ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration file://initiate-worm-configuration.json

    • Gunakan parameter JSON di baris perintah

      ossutil api initiate-bucket-worm --bucket examplebucket --initiate-worm-configuration "{\"RetentionPeriodInDays\":\"365\"}"