Obtaining Bucket Versioning Status
Functions
This operation allows a bucket owner to get the versioning status of the bucket.
If versioning is not configured for a bucket, no versioning status information will be returned following this operation.
Request Syntax
GET /?versioning HTTP/1.1Host: bucketname.obs.region.example.comDate: dateAuthorization: authorization
Request Parameters
This request contains no message parameters.
Request Headers
This request uses common headers. For details, see Table 3.
Request Elements
This request involves no elements.
Response Syntax
HTTP/1.1 status_codeDate: dateContent-Type: typeContent-Length: length<VersioningConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/"><Status>status</Status></VersioningConfiguration>
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response contains elements to specify the bucket versioning status. Table 1 describes the elements.
Element | Description |
---|---|
VersioningConfiguration | Element of versioning status information. Type: container |
Status | Versioning status of the bucket. Type: string Value options: Enabled, Suspended |
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
GET /?versioning HTTP/1.1User-Agent: curl/7.29.0Host: examplebucket.obs.region.example.comAccept: */*Date: WED, 01 Jul 2015 03:15:20 GMTAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:4N5qQIoluLO9xMY0m+8lIn/UWXM=
Sample Response
HTTP/1.1 200 OKServer: OBSx-obs-request-id: BF260000016436BBA4930622B4FC9F17x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSQIrNJ5/Ag6EPN8DAwWlPWgBc/xfBnxContent-Type: application/xmlDate: WED, 01 Jul 2015 03:15:20 GMTContent-Length: 180<?xml version="1.0" encoding="UTF-8" standalone="yes"?><VersioningConfiguration xmlns="http://obs.example.com/doc/2015-06-30/"><Status>Enabled</Status></VersioningConfiguration>
- Functions
- Request Syntax
- Request Parameters
- Request Headers
- Request Elements
- Response Syntax
- Response Headers
- Response Elements
- Error Responses
- Sample Request
- Sample Response