GET Bucket consistency request

The GET Bucket consistency request allows you to determine the consistency level being applied to a particular bucket.

The default consistency controls are set to guarantee read-after-write for newly created objects. For more information on the Consistency-Control header, see information about how StorageGRID Webscale implements the S3 REST API.

You must have the s3:GetBucketConsistency permission to complete this operation.


Request HTTP Header Description
Authorization Specifies the AWS signature and the access key ID for the account to use for the request.
Date The date and time of the request.
Host The host name to which the request is directed.

Request example

GET /bucket?x-ntap-sg-consistency HTTP/1.1
Date: Sat, 29 Nov 2015 01:02:17 GMT
Authorization: AWS 9MOYPG9ACWPAJA1S72R5:jUGbYkLdBApjCWBgK4TxvOjfock=


Response HTTP Header Description
Connection Specifies whether the connection to the server is open or closed.
Content-Length The length of the response body.
Content-Type The Multipurpose Internet Mail Extensions (MIME) type of the response body.
Date The date and time of the response.
Server The server that created the response.
x-amz-request-id The identifier that uniquely identifies the request. Created by the S3 API.

In the response XML, <Consistency> will return one of the following values:

Response example

HTTP/1.1 200 OK
Date: Sat, 29 Nov 2015 01:02:18 GMT
Connection: CLOSE
Server: StorageGRID/10.3.0
x-amz-request-id: 12345
Content-Length: 127
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<Consistency xmlns="">default</Consistency>