Operasi ini digunakan untuk menanyakan status versi dari sebuah bucket.
Sintaksis permintaan
GET /? versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueHeader permintaan
Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.
Header respons
Semua header dalam respons terhadap permintaan DescribeRegions adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Elemen respons
Elemen | Tipe | 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:
Catatan Jika versi tidak diaktifkan untuk bucket, elemen Status tidak termasuk dalam elemen respons. |
Contoh
Contoh Permintaan
GET /?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****************Contoh Respons
Contoh respons untuk bucket yang versinya diaktifkan
HTTP/1.1 200 OK x-oss-request-id: 5CAC0342B7AEADE01700**** Date: Tue, 09 Apr 2019 02:28:18 GMT Content-Length: 121 Content-Type: application/xml Connection: keep-alive Server: AliyunOSS <? xml version="1.0" encoding="UTF-8"? > <VersioningConfiguration> <Status>Enabled</Status> </VersioningConfiguration>Contoh respons untuk bucket yang versinya dinonaktifkan
Jika versi dinonaktifkan untuk bucket yang diminta, status versi bucket tidak termasuk dalam body XML dari respons.
HTTP/1.1 200 OK x-oss-request-id: 5CAC015CB7AEADE01700**** Date: Tue, 09 Apr 2019 02:20:12 GMT Content-Length: 74 Content-Type: application/xml Connection: keep-alive Server: AliyunOSS <VersioningConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com"/>
OSS SDK
Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi GetBucketVersioning:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketVersioning, lihat get-bucket-versioning.
Kode kesalahan
Kode kesalahan | Kode status HTTP | Deskripsi |
AccessDenied | 403 | Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk menanyakan status versi dari bucket. Hanya pemilik bucket atau pengguna RAM yang memiliki izin GetBucketVersioning yang dapat menanyakan status versi dari bucket. |
NoSuchBucket | 404 | Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada. |