All Products
Search
Document Center

Object Storage Service:GetBucketVersioning

Last Updated:Jul 02, 2025

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: SignatureValue

Header 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:

  • Enabled: menunjukkan bahwa versi diaktifkan untuk bucket.

  • Suspended: menunjukkan bahwa versi dinonaktifkan untuk bucket.

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.