Only users with GetBucketVersioning permission can call the GetBucketVersioning interface. By default, the bucket owner has direct GetBucketVersioning permission; the owner can also grant this permission to other users. For detailed instructions on managing permissions using bucket policies, see Bucket Authorization Policy Management.

HNS buckets do not support the GetBucketVersioning interface.

Request syntax

GET /?versioning HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​

Request parameters and headers

The public request headers used by this request; see public parameters.

Name

Location

Type

Required

Sample value

Description

Name	Location	Type	Required	Sample value	Description
versioning	Query	String	Yes	-	Special identifier representing the GetBucketVersioning request.

Request body elements

No elements are used.

Response headers

The public response headers returned by this request; see public parameters.

Response body elements

Name

Type

Sample value

Description

Name	Type	Sample value	Description
Status	String	Enabled	Versioning status of the bucket, with the following values: Enabled: Versioning is enabled. Suspended: Versioning is suspended. Empty: Versioning is not enabled.

Sample request

GET /?versioning HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Wed, 20 Sep 2023 02:39:48 GMT​
Authorization: authorization string​

Sample response

HTTP/1.1 200 OK​
x-tos-id-2: ef60010a5b74f967650a5b74-ac1a2718-1qin80-GBV-cb-tos-front-aza-1        ​
x-tos-request-id: ef60010a5b74f967650a5b74-ac1a2718-1qin80-GBV-cb-tos-front-aza-1          ​
Date: Wed, 20 Sep 2023 02:28:54 GMT​
Content-Length: 20​
server: TosServer​
​
{​
    "Status": "Enabled"​
}​

Last updated: 2025.09.08 17:32:49

Public security network record in Beijing: No. 11010802032137