Resolving consistency errors when updating a bucket's compliance configuration

If a data center site or multiple Storage Nodes at a site become unavailable, you might need to help S3 tenant users apply changes to a bucket's compliance configuration.

About this task

Tenant users who have created compliant buckets can configure the bucket's compliance settings from the Tenant Manager, Tenant Management API, or the S3 REST API. For example, a tenant user might need to increase the retention period or put a bucket under a legal hold.

When a tenant user updates the compliance settings for an S3 bucket, StorageGRID attempts to immediately update the bucket's metadata across the grid. If the system is unable to update the bucket's metadata because a data center site or multiple Storage Nodes are unavailable, it displays an error message. Specifically:
  • Tenant Manager users see the following error message:

    screenshot of warning message if a service is down when you change bucket compliance settings

  • Tenant Management API users and S3 API users receive a response code of 503 Service Unavailable with similar message text.

To resolve this error, follow these steps.


  1. Attempt to make all Storage Nodes or sites available again as soon as possible.
  2. If you are unable to make enough of the Storage Nodes at each site available, contact technical support, who can help you recover nodes and ensure that compliance changes are consistently applied across the grid.
  3. Once the underlying issue has been resolved, remind the tenant user to retry their compliance configuration changes.