简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

PUT桶一致性

10/01/2025

PUT Bucket 一致性请求允许您指定应用于对存储桶执行的操作的一致性。

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

开始之前

您必须拥有 s3:PutBucketConsistency 权限，或者成为账户根，才能完成此操作。

要求

这 `x-ntap-sg-consistency`参数必须包含以下值之一：

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

一致性

描述

所有

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

强大的全球

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

强位点

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

新写后读

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

可用

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

*注意：*一般来说，您应该使用“Read-after-new-write”一致性。如果请求无法正常工作，请尽可能更改应用程序客户端行为。或者，配置客户端以指定每个 API 请求的一致性。仅在万不得已的情况下才在存储桶级别设置一致性。

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