-
Amazon S3
- S3 Bucket Acl Operations
- S3 Bucket Cors Operations
- S3 Bucket Is Stale Allowed Operations
- S3 Bucket Lifecycle Operation
- S3 Bucket List Uploads Operations
- S3 Bucket Location Operations
- S3 Bucket Operations
- S3 Bucket Versioning Operations
- S3 Bucket Versions Operations
- S3 Data Node Operation
- S3 Metadata Key List Operations
- S3 Metadata Key System List Operation
- S3 Metadata Search Operation
- S3 Multi Object Delete Operations
- S3 Object Acl Operations
- S3 Object Init Uploads Operations
- S3 Object Operations
- S3 Object Uploads Operations
- S3 Options Operations
- S3 Ping Operation
- EMC Atmos
- OpenStack SWIFT
- All Changes
-
Modified Services
- Data Store
- Password Group (Swift)
- S3 Bucket Acl Operations
- S3 Bucket Lifecycle Operation
- S3 Bucket Location Operations
- S3 Bucket Operations
- S3 Bucket Versioning Operations
- S3 Object Operations
- S3 Object Uploads Operations
- Secret Key
- Secret Key Self-Service
- Swift Account Operations
- Swift Container Operations
- Swift File Access Operations
- Swift Object Operations
- User (Object)

Update Bucket Is Stale Allowed
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.
bucketName | Name of the bucket for which isStaleAllowed is to be updated |
Required Roles
Requires one of the following roles:
SYSTEM_ADMIN
NAMESPACE_ADMIN
Prerequisites
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 |
<object_bucket_update_is_stale_allowed> | |||
<is_stale_allowed> | isStaleAllowed flag of the bucket | String |
Valid Values:
|
<namespace> | Namespace associated with the user/tenant that is allowed to access the bucket | String | |
</object_bucket_update_is_stale_allowed> |
Response Body
Response indicating Success or Failure of the operation
Examples
Request
POST https://192.168.0.0:4443/object/bucket/standalone-bucket/isstaleallowed HTTP/1.1 Content-Type: application/xml X-SDS-AUTH-TOKEN: <AUTH_TOKEN> <object_bucket_update_is_stale_allowed> <is_stale_allowed>false</is_stale_allowed> <namespace>s3</namespace> </object_bucket_update_is_stale_allowed>
Response
HTTP/1.1 200 OK Content-Type: application/xml