GET Bucket consistency要求

GET Bucket consistency要求を使用すると、特定のバケットに適用されている整合性レベルを確認できます。

新たに作成したオブジェクトに対しては、リードアフターライト整合性を保証するようにデフォルトの整合性制御が設定されます。Consistency-Controlヘッダーの詳細については、StorageGRID WebscaleでのS3 REST APIの実装に関する情報を参照してください。

この処理を完了するには、s3:GetBucketConsistency権限が必要です。

要求

要求のHTTPヘッダー	説明
Authorization	要求に使用するAWS署名とアカウントのアクセスキーIDを示します。
Date	要求の日付と時刻です。
Host	要求の転送先のホスト名です。

要求例

GET /bucket?x-ntap-sg-consistency HTTP/1.1
Date: Sat, 29 Nov 2015 01:02:17 GMT
Authorization: AWS 9MOYPG9ACWPAJA1S72R5:jUGbYkLdBApjCWBgK4TxvOjfock=
Host: test.com

応答

応答のHTTPヘッダー	説明
Connection	サーバへの接続が開いているかどうかを示します。
Content-Length	応答の本文の長さです。
Content-Type	応答の本文のMultipurpose Internet Mail Extensions（MIME）タイプです。
Date	応答の日付と時刻です。
Server	応答を作成したサーバです。
x-amz-request-id	要求を一意に識別する識別子です。S3 APIで作成されます。

応答XMLで、<Consistency>から次のいずれかの値が返されます。

all：最高レベルのリードアフターライト整合性が保証されます。すべてのノードが即座にデータを受け取り、受け取れない場合は要求が失敗します。
strong-global：すべてのサイトにおけるすべてのクライアント要求について、リードアフターライト整合性が保証されます。
strong-site：1つのサイトにおけるすべてのクライアント要求について、リードアフターライト整合性が保証されます。
default（新規についてはリードアフターライトを提供）：新規オブジェクトについてはリードアフターライト整合性が提供され、オブジェクトの更新については結果整合性が提供されます。高可用性が確保され、データ保護が保証されます。AWS S3の整合性に相当します。
注:アプリケーションが存在しないキーに対してHEAD処理を試行する場合は、AWS S3の整合性が必要ないかぎり、整合性レベルをAvailableに設定してください。そうしないと、使用できないストレージノードがある場合に「500 Internal Server Error」が大量に発生する可能性があります。
available（HEAD処理については結果整合性を提供）：default整合性レベルと動作は同じですが、HEAD処理については結果整合性のみ提供されます。ストレージノードを使用できない場合に、HEAD処理に対してDefaultよりも高い可用性が提供されます。AWS S3の整合性と異なるのはHEAD処理のみです。
weak：結果整合性と高可用性が提供され、最低限のデータ保護が保証されます（特に、ストレージノードが障害または使用不可の状態に陥った場合）。高可用性を必要とし、リードアフターライト整合性は必要とせず、ノードに障害が発生した場合のデータ損失を許容できる、書き込み負荷の高いワークロードにのみ適しています。

応答例

HTTP/1.1 200 OK
Date: Sat, 29 Nov 2015 01:02:18 GMT
Connection: CLOSE
Server: StorageGRID/10.3.0
x-amz-request-id: 12345
Content-Length: 127
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<Consistency xmlns="http://s3.storagegrid.com/doc/2015-02-01/">default</Consistency>