バケットの処理

StorageGRIDシステムでは、S3テナントアカウントあたり最大1,000個のバケットがサポートされます。

バケット名については、AWS US Standardリージョンの制限が適用されますが、S3仮想ホスト形式の要求をサポートするためにDNSの命名規則にも従う必要があります。

GET Bucket (List Objects)処理とGET Bucket versions処理では、StorageGRIDの整合性制御がサポートされます。

最終アクセス時間の更新が個々のバケットで有効になっているか無効になっているかを確認することができます。

次の表に、StorageGRIDでのS3 REST APIバケット処理の実装方法を示します。これらの処理を実行するには、必要なアクセスクレデンシャルがアカウントに付与されている必要があります。

処理	実装
DELETE Bucket	Amazon S3 REST APIのすべての動作が実装されています。
DELETE Bucket cors	この処理では、バケットのCORS設定が削除されます。
DELETE Bucket policy	この処理では、バケットに関連付けられているポリシーが削除されます。
DELETE Bucket replication	この処理では、バケットに関連付けられているレプリケーション設定が削除されます。
GET Bucket (List Objects)、バージョン1およびバージョン2	この処理では、バケット内のオブジェクトの一部またはすべて（最大1,000）が返されます。 `REDUCED_REDUNDANCY`ストレージクラスオプションを使用してオブジェクトを取り込んだ場合でも、オブジェクトのストレージクラスには次のどちらかの値が返されます。 `STANDARD`。オブジェクトがストレージノードで構成されるストレージプールに格納されていることを示します。 `GLACIER`。オブジェクトがクラウドストレージプールによって指定された外部バケットに移動されたことを示します。
GET Bucket acl	この処理では、バケットの所有者にバケットに対するフルアクセスがあることを示す応答が返され、所有者のID、表示名、および権限が表示されます。
GET Bucket cors	この処理では、バケットの`cors`設定が返されます。
GET Bucket location	この処理では、バケットのリージョンが返されます。デフォルトでは、PUT Bucket要求で`LocationConstraint`要素を使用してリージョンが設定されていないかぎり、`us-east-1`が返されます。
GET Bucket Object versions	バケットに対するREADアクセスがある場合、`versions`サブリソースを使用して、バケット内のオブジェクトのすべてのバージョンのメタデータのリストが表示されます。
GET Bucket notification	この処理では、バケットに関連付けられている通知設定が返されます。
GET Bucket policy	この処理では、バケットに関連付けられているポリシーが返されます。
GET Bucket replication	この処理では、バケットに関連付けられているレプリケーション設定が返されます。
GET Bucket versioning	versioningサブリソースを使用して、バケットのバージョン管理の状態を取得できます。バケットがバージョン管理に対応していない場合は「Unversioned」、バージョン管理が有効になっている場合は「Enabled」、バージョン管理が一時停止中の場合は「Suspended」が返されます。
HEAD Bucket	この処理では、バケットが存在し、そのバケットへのアクセス権限があるかどうかが判断されます。
PUT Bucket	この処理では、新しいバケットが作成されます。バケットを作成すると、そのバケットの所有者になります。バケット名は次のルールを満たす必要があります。 StorageGRIDシステム全体で（テナントアカウント内だけではなく）一意である必要があります。 DNSに準拠している必要があります。パスワードは3～63文字で指定する必要があります。 1つまたは一連の複数のラベルを指定できます。隣接するラベルはピリオドで区切ります。使用可能な文字は、小文字のアルファベット、数字、ハイフンのみで、各ラベルの先頭と末尾の文字は小文字のアルファベットか数字にする必要があります。テキスト形式のIPアドレスにはできません。ピリオドが原因でサーバワイルドカード証明書の検証で問題が発生するため、仮想ホスト形式の要求でピリオドを使用しないでください。デフォルトではバケットは`us-east-1`リージョンに作成されますが、要求の本文で`LocationConstraint` 要求要素を使用し、別のリージョンを指定できます。`LocationConstraint`要素を使用する場合は、Grid Managerまたはグリッド管理APIを使用して定義されたリージョンの正確な名前を指定する必要があります。使用すべきリージョン名がわからない場合は、システム管理者にお問い合わせください。注:StorageGRIDで定義されていないリージョンをPUT Bucket要求で使用すると、エラーが発生します。 PUT Bucket要求を使用する場合は、XML要求の本文に`SGCompliance`XML要素を含めることができます。`SGCompliance`はカスタムのStorageGRID要素で、準拠バケットを作成できます。
PUT Bucket cors	この処理では、バケットのCORS設定を指定し、クロスオリジン要求を処理できるようにします。 Cross-Origin Resource Sharing（CORS）は、あるドメインのクライアントWebアプリケーションが別のドメインのリソースにアクセスできるようにするセキュリティ機能です。たとえば、`images`という名前のS3バケットを使用してグラフィックを格納するとします。`images`バケットに対してCORS設定を指定することで、そのバケット内の画像をWebサイト`http://www.example.com`に表示できます。
PUT Bucket notification	この処理では、要求の本文に含まれる通知設定XMLを使用してバケットの通知を設定します。実装に関する次の詳細事項に注意してください。 StorageGRIDでは、Simple Notification Service（SNS）のトピックがデスティネーションとしてサポートされます。Simple Queue Service（SQS）エンドポイントまたはAmazon Lambdaエンドポイントはサポートされません。通知のデスティネーションは、StorageGRIDエンドポイントのURNとして指定する必要があります。エンドポイントは、Tenant Managerまたはテナント管理APIを使用して作成できます。通知設定が機能するためには、エンドポイントが存在している必要があります。エンドポイントが存在しない場合は、`400 Bad Request`エラーがコード`InvalidArgument`とともに返されます。 `s3:ReducedRedundancyLostObject`イベントの通知はサポートされません。イベント通知メッセージではほとんどのキーに標準値が使用されますが、次のキーは例外です。 `eventSource`は`sgws:s3`を返します。 `awsRegion`：このキーは返されません。 `x-amz-id-2`：このキーは返されません。 `arn`は`urn:sgws:s3:::bucket-name`
PUT Bucket policy	この処理では、バケットに関連付けられているポリシーが設定されます。
PUT Bucket replication	この処理では、要求の本文に含まれるレプリケーション設定XMLを使用して、バケットのStorageGRID CloudMirrorレプリケーションが設定されます。 CloudMirrorレプリケーションについては、実装に関する次の詳細事項に注意してください。バケットレプリケーションは、バージョン管理されているバケットでもバージョン管理されていないバケットでも設定できます。レプリケーション設定XMLの各ルールで異なるデスティネーションバケットを指定できます。1つのソースバケットを複数のデスティネーションバケットにレプリケートできます。デスティネーションバケットは、Tenant Managerまたはテナント管理APIで指定されたStorageGRIDエンドポイントのURNとして指定する必要があります。レプリケーション設定が機能するためには、エンドポイントが存在している必要があります。エンドポイントが存在しない場合は、`400 Bad Request`として要求が失敗します。エラーメッセージ：`Unable to save the replication policy. The specified endpoint URN does not exist: URN`. 設定XMLで`Role`を指定する必要はありません。この値はStorageGRIDでは使用されず、送信されても無視されます。設定XMLでストレージクラスを省略した場合、StorageGRIDではデフォルトで`STANDARD`ストレージクラスが使用されます。ソースバケットからオブジェクトを削除する場合、またはソースバケット自体を削除する場合、クロスリージョンレプリケーションは次のように動作します。レプリケートの前にオブジェクトまたはバケットを削除すると、オブジェクトまたはバケットはレプリケートされず、通知は届きません。レプリケートのあとにオブジェクトまたはバケットを削除すると、StorageGRIDは、クロスリージョンレプリケーションに対するAmazon S3の通常の削除動作に従います。
PUT Bucket versioning	versioningサブリソースを使用して、既存のバケットのバージョン管理の状態を設定できます。バージョン管理の状態は、次のいずれかの値に設定できます。 Enabled：バケット内のオブジェクトに対してバージョン管理を有効にします。バケットに追加されるすべてのオブジェクトに、一意のバージョンIDが割り当てられます。 Suspended：バケット内のオブジェクトに対してバージョン管理を無効にします。バケットに追加されるすべてのオブジェクトに、バージョンID nullが割り当てられます。