All Products
Search
Document Center

Object Storage Service:put-bucket-versioning

Last Updated:Jul 02, 2025

Mengonfigurasi versioning untuk sebuah bucket.

Catatan penggunaan

  • Sebelum mengonfigurasi status versioning untuk sebuah bucket, Anda harus memiliki izin PutBucketVersioning.

  • Sebuah bucket dapat berada dalam salah satu dari tiga status versioning: dinonaktifkan, diaktifkan, atau ditangguhkan. Secara default, versioning dinonaktifkan untuk sebuah bucket.

  • Jika versioning diaktifkan untuk sebuah bucket, OSS menghasilkan ID versi unik untuk semua objek yang ditambahkan ke bucket tersebut. Dalam hal ini, OSS menyimpan beberapa versi objek.

  • Jika versioning ditangguhkan untuk sebuah bucket, OSS menghasilkan ID versi null untuk semua objek yang ditambahkan ke bucket tersebut. Dalam hal ini, OSS tidak menyimpan versi baru untuk objek yang dihapus atau ditimpa.

Untuk informasi lebih lanjut tentang versioning, lihat Versioning.

Sintaks perintah

ossutil api put-bucket-versioning --bucket value --versioning-configuration value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--versioning-configuration

string

Kontainer yang menyimpan konfigurasi versioning.

Catatan

Perintah put-bucket-versioning setara dengan operasi PutBucketVersioning. Untuk informasi lebih lanjut tentang operasi API, lihat PutBucketVersioning.

--versioning-configuration

Opsi --versioning-configuration mendukung format XML dan JSON:

  • Format XML:

    <VersioningConfiguration>
      <Status>string</Status>
    </VersioningConfiguration>
  • Format JSON:

    {
      "Status": "string"
    }
Catatan

Untuk informasi lebih lanjut, lihat Opsi Baris Perintah.

Contoh

Mengonfigurasi versioning untuk sebuah bucket bernama examplebucket.

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

    <?xml version="1.0" encoding="UTF-8"?>
    <VersioningConfiguration>
            <Status>Enabled</Status>
    </VersioningConfiguration>

    Contoh perintah:

    ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.xml
  • Gunakan file konfigurasi JSON (versioning-configuration.json dalam contoh ini)

    {
            "Status": "Enabled"
    }

    Contoh perintah:

    ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.json
  • Gunakan parameter JSON di baris perintah

    ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration "{\"Status\":\"Enabled\"}"