PUT Bucket consistency要求

PUT Bucket consistency要求を使用すると、バケットで実行される処理に適用する整合性レベルを指定できます。

新たに作成したオブジェクトに対しては、リードアフターライト整合性を保証するようにデフォルトの整合性制御が設定されます。

この処理を完了するには、s3:PutBucketConsistency権限またはrootアカウントが必要です。

要求

x-ntap-sg-consistencyパラメータには、次のいずれかの値を指定する必要があります。

整合性制御 説明
all 最高レベルのリードアフターライト整合性が保証されます。すべてのノードが即座にデータを受け取り、受け取れない場合は要求が失敗します。
strong-global すべてのサイトのすべてのクライアント要求について、リードアフターライト整合性が保証されます。
strong-site あるサイト内のすべてのクライアント要求について、リードアフターライト整合性が保証されます。
read-after-new-write (デフォルト)新規オブジェクトにはリードアフターライト整合性を、オブジェクトの更新には結果整合性を提供します。高可用性が確保され、データ保護が保証されます。AWS S3の整合性に相当します。
注:存在しないオブジェクトに対してアプリケーションがHEAD要求を使用すると、使用できないストレージ ノードがある場合に「500 Internal Server Error」が大量に返される可能性があります。このエラーを回避するには、AWS S3と同様の整合性の保証が必要ないかぎり、整合性制御を「available」に設定します。
available(HEAD処理は結果整合性) 「read-after-new-write」整合性レベルと動作は同じですが、HEAD処理については結果整合性のみを提供します。ストレージ ノードを使用できない場合に、HEAD処理に対して「read-after-new-write」よりも高い可用性が提供されます。AWS S3の整合性と異なるのはHEAD処理のみです。
weak 結果整合性と高い可用性を提供し、特にストレージ ノードに障害が発生したりストレージ ノードを使用できない場合のデータ保護の保証は最小限です。高可用性を必要とし、リードアフターライト整合性は必要とせず、ノードに障害が発生した場合のデータ損失を許容できる、書き込み負荷の高いワークロードにのみ適しています。
注:一般には、「read-after-new-write」整合性制御値を使用する必要があります。要求が正しく機能しない場合は、アプリケーション クライアントの動作を変更します(可能な場合)。あるいは、API要求ごとに整合性制御を指定するようにクライアントを設定します。バケット レベルの整合性制御は最後の手段と考えてください。

要求例

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