PUT Bucket整合性リクエストを使用してStorageGRIDで整合性レベルを指定する
PUT Bucket整合性リクエストを使用すると、バケットに対して実行される操作に適用する整合性を指定できます。
デフォルトの整合性設定では、新しく作成されたオブジェクトに対して書き込み後の読み取りを保証するようになっています。
この操作を完了するには、s3:PutBucketConsistency 権限が必要です。またはアカウントのrootである必要があります。
要求
`x-ntap-sg-consistency`パラメータには、以下のいずれかの値を含める必要があります:
| 一貫性 | 説明 |
|---|---|
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