使用 PUT Bucket 一致性请求在 StorageGRID 中指定一致性级别

07/23/2026

通过PUT Bucket一致性请求，可以指定要应用于对存储桶执行的操作的一致性。

默认一致性设置为保证新创建对象的写后读一致性。

开始之前

您必须具有 s3:PutBucketConsistency 权限或帐户根用户权限，才能完成此操作。

请求

The x-ntap-sg-consistency 参数必须包含以下其中一个值：

一致性	问题描述
all	所有节点立即接收数据，否则请求将失败。
strong-global	保证所有站点上所有客户端请求的写后读一致性。
strong-site	保证站点内所有客户端请求的写后读一致性。
新写入后立即读取	（默认值）为新对象提供写后读取一致性，并为对象更新提供最终一致性。提供高可用性和数据保护保证。建议在大多数情况下使用。
可用	为新对象和对象更新提供最终一致性。对于 S3 存储桶，仅根据需要使用（例如，对于包含很少读取的日志值的存储桶，或者对于不存在的键的 HEAD 或 GET 操作）。不支持 S3 FabricPool 存储桶。

一致性

问题描述

all

所有节点立即接收数据，否则请求将失败。

strong-global

保证所有站点上所有客户端请求的写后读一致性。

strong-site

保证站点内所有客户端请求的写后读一致性。

新写入后立即读取

（默认值）为新对象提供写后读取一致性，并为对象更新提供最终一致性。提供高可用性和数据保护保证。建议在大多数情况下使用。

可用

为新对象和对象更新提供最终一致性。对于 S3 存储桶，仅根据需要使用（例如，对于包含很少读取的日志值的存储桶，或者对于不存在的键的 HEAD 或 GET 操作）。不支持 S3 FabricPool 存储桶。

注意： 一般来说，您应该使用"新写后读"的一致性。如果请求无法正常工作，请尽可能更改应用程序客户端行为。或者，配置客户端以指定每个 API 请求的一致性。仅作为最后手段，在存储桶级别设置一致性。

PUT /bucket?x-ntap-sg-consistency=strong-global HTTP/1.1
Date: date
Authorization: authorization string
Host: host