Bucket:Update Bucket Is Stale Allowed

Search (SHIFT+S)

New in this release

Update Bucket Is Stale Allowed

POST /object/bucket/{bucketName}/isstaleallowed

Updates isStaleAllowed details for the specified bucket in order to enable access to the bucket during a temporary site outage. If namespace does not exist in the request payload, the current user's namespace is used.

If you set this flag ON, and a temporary site outage occurs, objects that you access in this bucket might have been updated at the failed site but changes might not have been propagated to the site from which you are accessing the object.Hence, you are prepared to accept that the objects you read might not be up to date.

If the flag is turned OFF, data in the zone which has the temporary outage is not available for access from other zones and object reads for data which has its primary in the failed site will fail.

bucketNameName of the bucket for which isStaleAllowed is to be updated

Required Roles

Requires one of the following roles:




The following conditions must be met in order to call this operation.

  • Bucket must exist.

Request Payload

All parameters are required unless otherwise stated.

Field Description Type Notes
<is_stale_allowed> isStaleAllowed flag of the bucket String Valid Values:
  •  True
  •  False
<namespace> Namespace associated with the user/tenant that is allowed to access the bucket String

Response Body

Response indicating Success or Failure of the operation



Content-Type: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml