PutBucketVersioning - Object Storage Service

Mengonfigurasi status versi untuk sebuah bucket.

Catatan penggunaan

Sebelum mengonfigurasi status versi untuk sebuah bucket, Anda harus memiliki izin PutBucketVersioning.
Sebuah bucket dapat berada dalam salah satu dari tiga status versi: dinonaktifkan, diaktifkan, atau ditangguhkan. Secara default, versi dinonaktifkan untuk sebuah bucket.
Jika versi diaktifkan untuk sebuah bucket, OSS menghasilkan ID versi unik untuk semua objek yang ditambahkan ke bucket tersebut. Dalam hal ini, OSS menyimpan beberapa versi dari objek-objek tersebut.
Jika versi 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-objek yang dihapus atau ditimpa.

Untuk informasi lebih lanjut tentang versi, lihat Versi.

Sintaks permintaan

PUT /?versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Enabled</Status>
</VersioningConfiguration>

Header permintaan

Semua header dalam permintaan DescribeRegions adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Parameter permintaan

Parameter

Tipe

Diperlukan

Contoh

Deskripsi

VersioningConfiguration

Container

Tidak tersedia

Wadah yang menyimpan status versi dari bucket.

Node anak: Status

Node induk: tidak ada

Status

String

Enabled

Status versi dari bucket.

Node induk: VersioningConfiguration

Nilai valid:

Enabled: menunjukkan bahwa versi diaktifkan untuk bucket.
Suspended: menunjukkan bahwa versi ditangguhkan untuk bucket.

Header respons

Semua header dalam respons terhadap permintaan DescribeRegions adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh permintaan untuk mengaktifkan versi pada sebuah bucket

PUT /?versioning HTTP/1.1
Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 02:20:12 GMT
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Enabled</Status>
</VersioningConfiguration>

Contoh respons

HTTP/1.1 200 OK
x-oss-request-id: 5CAC015CB7AEADE01700****
Date: Tue, 09 Apr 2019 02:20:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

Contoh permintaan untuk menangguhkan versi pada sebuah bucket

PUT /?versioning HTTP/1.1
Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 02:28:18 GMT
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Suspended</Status>
</VersioningConfiguration>

Contoh respons

HTTP/1.1 200 OK
x-oss-request-id: 5CAC0342B7AEADE01700****
Date: Tue, 09 Apr 2019 02:28:18 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

OSS SDKs

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

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketVersioning, lihat put-bucket-versioning.

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
AccessDenied	403	Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk mengonfigurasi status versi untuk bucket.
InvalidArgument	400	Pesan kesalahan yang dikembalikan karena status versi yang ingin Anda konfigurasikan tidak valid. Anda hanya dapat mengatur status versi sebuah bucket menjadi Enabled atau Suspended.