Skip to main content
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

バケットの処理

共同作成者
PDF

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

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

詳細については、次を参照してください。

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

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

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

操作 実装

バケットを削除します

この処理では、バケットが削除されます。

バケットの CORS を削除します

この処理は、バケットの CORS 設定を削除します。

バケットの暗号化を削除

この処理は、バケットからデフォルトの暗号化を削除します。既存の暗号化オブジェクトは暗号化されたままですが、バケットに追加された新しいオブジェクトは暗号化されません。

バケットライフサイクルを削除

この処理は、バケットからライフサイクル設定を削除します。を参照してください "S3 ライフサイクル設定を作成する"。

バケットポリシーを削除

この処理は、バケットに関連付けられているポリシーを削除します。

バケットレプリケーションを削除します

この処理は、バケットに関連付けられているレプリケーション設定を削除します。

バケットのタグ付けを削除します

この処理にはを使用します tagging サブリソース：バケットからすべてのタグを削除します。

GET Bucket

（ListObjects）

（ListObjectsV2）

この処理は、バケット内のオブジェクトの一部またはすべて（最大 1 、 000 ）を返します。を使用してオブジェクトを取り込んだ場合でも、オブジェクトのストレージクラスには2つの値が設定されます REDUCED_REDUNDANCY ストレージクラスのオプション：

  • `STANDARD`を指定します。このオブジェクトは、ストレージノードで構成されるストレージプールに格納されます。

  • `GLACIER`を指定します。このオブジェクトは、クラウドストレージプールで指定された外部バケットに移動されています。

バケットに同じプレフィックスを持つ削除済みキーが多数含まれている場合、応答に一部のキーが含まれることがあります CommonPrefixes 鍵が入っていないものです

GET Bucket Object versions

（ListObjectVersions）

バケットに対する読み取りアクセスで、を使用した処理 versions サブリソースには、バケット内のオブジェクトのすべてのバージョンのメタデータが表示されます。

GET Bucket ACL の場合

この処理では、バケットの所有者にバケットに対するフルアクセスがあることを示す応答が返され、所有者の ID 、表示名、および権限が表示されます。

GET Bucket CORS

この処理を実行するとが返されます cors バケットの設定。

GET Bucket encryption

この処理は、バケットのデフォルトの暗号化設定を返します。

GET Bucket lifecycle

（GetBucketLifecycleConfiguration）

この処理は、バケットのライフサイクル設定を返します。を参照してください "S3 ライフサイクル設定を作成する"。

GET Bucket location の各ノードで使用でき

この操作は、を使用して設定されたリージョンを返します LocationConstraint PUT Bucket要求の要素。バケットのリージョンがの場合 `us-east-1`を指定すると、リージョンに対して空の文字列が返されます。

GET Bucket notification

（GetBucketNotificationConfiguration）

この処理は、バケットに関連付けられている通知設定を返します。

GET Bucket policy の場合

この処理は、バケットに関連付けられているポリシーを返します。

GET Bucket replication

この処理は、バケットに関連付けられているレプリケーション設定を返します。

GET Bucket tagging

この処理にはを使用します tagging サブリソース：バケットのすべてのタグを返す

GET Bucket versioning

この実装ではを使用します versioning サブリソース：バケットのバージョン管理の状態を返します。

  • blank: バージョン管理は有効になっていません ( バケットはバージョン管理されていません )

  • 有効：バージョン管理が有効になっています

  • 中断：バージョン管理は以前有効になっていて、中断されています

オブジェクトロック設定の取得

この処理では、バケットのデフォルトの保持モードとデフォルトの保持期間（設定されている場合）が返されます。

を参照してください "S3 REST APIを使用してS3オブジェクトロックを設定します"。

HEAD Bucket （ヘッドバケット）

この処理は、バケットが存在し、そのバケットへのアクセス権限があるかどうかを判断します。

この処理から返される情報は次の

  • x-ntap-sg-bucket-id：バケットのUUID（UUID形式）。

  • x-ntap-sg-trace-id：関連付けられた要求の一意のトレースID。

PUT Bucket の場合

この処理は、新しいバケットを作成します。バケットを作成すると、そのバケットの所有者になります。

  • バケット名は次のルールを満たす必要があります。

    • StorageGRID システム全体で（テナントアカウント内だけではなく）一意である必要があります。

    • DNS に準拠している必要があります。

    • 3 文字以上 63 文字以下にする必要があります。

    • 1 つ以上のラベルを連続して指定できます。隣接するラベルはピリオドで区切ります。各ラベルの先頭と末尾の文字は小文字のアルファベットか数字にする必要があり、使用できる文字は小文字のアルファベット、数字、ハイフンのみです。

    • テキスト形式の IP アドレスのようにはできません。

    • 仮想ホスト形式の要求でピリオドを使用しないでください。ピリオドを使用すると、サーバワイルドカード証明書の検証で原因 の問題が発生します。

  • デフォルトでは、バケットはに作成されます us-east-1 リージョン。ただし、を使用することはできます LocationConstraint 別のリージョンを指定するように要求本文内の要求要素。を使用する場合 LocationConstraint 要素：Grid Managerまたはグリッド管理APIを使用して定義されているリージョンの正確な名前を指定する必要があります。使用するリージョン名がわからない場合は、システム管理者にお問い合わせください。

  • 注： StorageGRID で定義されていないリージョンを PUT Bucket 要求で使用すると、エラーが発生します。

  • を含めることができます x-amz-bucket-object-lock-enabled S3オブジェクトのロックを有効にしてバケットを作成する要求ヘッダー。を参照してください "S3 REST APIを使用してS3オブジェクトロックを設定します"。

    バケットの作成時に S3 オブジェクトのロックを有効にする必要があります。バケットの作成後にS3オブジェクトロックを追加または無効にすることはできません。S3 オブジェクトロックにはバケットのバージョン管理が必要です。バケットの作成時に自動的に有効になります。

PUT Bucket CORS

この処理は、バケットの CORS 設定を指定し、クロスオリジン要求を処理できるようにします。Cross-Origin Resource Sharing （ CORS ）は、あるドメインのクライアント Web アプリケーションが別のドメインのリソースにアクセスできるようにするセキュリティ機能です。たとえば、というS3バケットを使用するとします images グラフィックを保存します。のCORS設定を指定します images バケットを使用すると、そのバケット内の画像をWebサイトに表示できます http://www.example.com。

PUT Bucket encryption

この処理は、既存のバケットのデフォルトの暗号化状態を設定します。バケットレベルの暗号化が有効な場合は、バケットに追加されたすべての新しいオブジェクトが暗号化されます。 StorageGRID では、 StorageGRID で管理されるキーによるサーバ側の暗号化がサポートされます。サーバ側の暗号化設定ルールを指定する場合は、を設定します SSEAlgorithm パラメータの値 AES256`を使用しないでください `KMSMasterKeyID パラメータ

バケットのデフォルトの暗号化設定は、オブジェクトのアップロード要求ですでに暗号化が指定されている場合（要求にが含まれている場合）は無視されます x-amz-server-side-encryption-* 要求ヘッダー）。

PUT Bucket lifecycle の場合

（PutBucketLifecycleConfiguration）

この処理は、バケットの新しいライフサイクル設定を作成するか、既存のライフサイクル設定を置き換えます。StorageGRID では、 1 つのライフサイクル設定で最大 1 、 000 個のライフサイクルルールがサポートされます。各ルールには、次の XML 要素を含めることができます。

  • 有効期限（日数、日付）

  • NoncurrentVersionExpiration （ NoncurrentDays ）

  • フィルタ（プレフィックス、タグ）

  • ステータス

  • ID

StorageGRID では、次のアクションはサポートされません。

  • AbortIncompleteMultipartUpload の略

  • ExpiredObjectDeleteMarker

  • 移行

を参照してください "S3 ライフサイクル設定を作成する"。バケットライフサイクルのExpirationアクションとILMの配置手順の相互作用については、を参照してください "オブジェクトのライフサイクル全体にわたる ILM の動作"。

  • 注：バケットライフサイクル設定は S3 オブジェクトロックが有効なバケットで使用できますが、従来の準拠バケットではバケットライフサイクル設定がサポートされません。

PUT Bucket notification

（PutBucketNotificationConfiguration）

この処理は、要求の本文に含まれる通知設定 XML を使用してバケットの通知を設定します。実装に関する次の詳細事項に注意してください。

  • StorageGRID では、 Simple Notification Service （ SNS ）のトピックがデスティネーションとしてサポートされます。Simple Queue Service（SQS）またはAmazon Lambdaエンドポイントはサポートされていません。

  • 通知のデスティネーションは、 StorageGRID エンドポイントの URN として指定する必要があります。エンドポイントは、 Tenant Manager またはテナント管理 API を使用して作成できます。

    通知設定が機能するためには、エンドポイントが存在している必要があります。エンドポイントが存在しない場合は、 400 Bad Request エラーがコードとともに返されます InvalidArgument。

  • 次のイベントタイプに対して通知を設定することはできません。これらのイベントタイプは * サポートされていません。

    • s3:ReducedRedundancyLostObject

    • s3:ObjectRestore:Completed

  • StorageGRID から送信されるイベント通知は標準のJSON形式を使用しますが、次のリストに示すように、一部のキーが含まれず、他のキーには特定の値が使用されます。

    • * eventSource*

      sgws:s3

    • * awsRegion *

      含まれません

    • * x-amz-id-2 *

      含まれません

    • * arn *

      urn:sgws:s3:::bucket_name

PUT Bucket policy の場合

この処理は、バケットに関連付けられているポリシーを設定します。

PUT Bucket replication

この操作は、を設定します "StorageGRID CloudMirrorレプリケーション" （バケット用）。要求の本文に含まれるレプリケーション設定XMLを使用します。CloudMirror レプリケーションについては、実装に関する次の詳細事項に注意してください。

  • StorageGRID では、 V1 のレプリケーション設定のみがサポートされます。つまり、StorageGRID では、の使用はサポートされていません Filter ルールのエレメント。V1の規則に従ってオブジェクトバージョンを削除します。詳細については、を参照してください "レプリケーション設定に関する Amazon S3 のドキュメント"。

  • バケットレプリケーションは、バージョン管理されているバケットでもバージョン管理されていないバケットでも設定でき

  • レプリケーション設定 XML の各ルールで異なるデスティネーションバケットを指定できます。1 つのソースバケットを複数のデスティネーションバケットにレプリケートできます。

  • デスティネーションバケットは、テナントマネージャまたはテナント管理 API で指定された StorageGRID エンドポイントの URN として指定する必要があります。を参照してください "CloudMirror レプリケーションを設定します"。

    レプリケーション設定が機能するためには、エンドポイントが存在している必要があります。エンドポイントが存在しない場合は、として要求が失敗します 400 Bad Request。エラーメッセージ： Unable to save the replication policy. The specified endpoint URN does not exist: URN.

  • を指定する必要はありません Role 設定XMLを使用します。この値は StorageGRID では使用されず、送信されても無視されます。

  • 設定XMLでストレージクラスを省略した場合、StorageGRID ではを使用します STANDARD デフォルトのストレージクラス。

  • ソースバケットからオブジェクトを削除する場合、またはソースバケット自体を削除する場合、クロスリージョンレプリケーションは次のように動作します。

    • レプリケートの前にオブジェクトまたはバケットを削除した場合、オブジェクトまたはバケットはレプリケートされず、通知も送信されません。

    • レプリケートのあとにオブジェクトまたはバケットを削除すると、 StorageGRID は、 V1 のクロスリージョンレプリケーションに対する Amazon S3 の通常の削除動作に従います。

PUT Bucket tagging

この処理にはを使用します tagging サブリソース：バケットの一連のタグを追加または更新できます。バケットタグを追加する場合は、次の制限事項に注意してください。

  • StorageGRID と Amazon S3 はどちらもバケットごとに最大 50 個のタグをサポートします。

  • バケットに関連付けられているタグには、一意のタグキーが必要です。タグキーには Unicode 文字を 128 文字まで使用できます。

  • タグ値には、 Unicode 文字を 256 文字以内で指定します。

  • キーと値では大文字と小文字が区別されます。

PUT Bucket versioning の場合

この実装ではを使用します versioning サブリソース：既存のバケットのバージョン管理の状態を設定できます。バージョン管理の状態は、次のいずれかの値に設定できます。

  • Enabled ：バケット内のオブジェクトに対してバージョン管理を有効にします。バケットに追加されるすべてのオブジェクトに、一意のバージョン ID が割り当てられます。

  • Suspended ：バケット内のオブジェクトに対してバージョン管理を無効にします。バケットに追加されるすべてのオブジェクトに、バージョンIDが割り当てられます null。

PUT Object Lock の設定を指定します

この処理は、バケットのデフォルト保持モードとデフォルトの保持期間を設定または削除します。

デフォルトの保持期間を変更した場合、既存のオブジェクトバージョンの retain-until はそのまま残り、新しいデフォルトの保持期間を使用して再計算されることはありません。

を参照してください "S3 REST APIを使用してS3オブジェクトロックを設定します" を参照してください。
関連情報

"整合性制御"

"GET Bucket last access time の場合"

"バケットとグループのアクセスポリシーを使用"

"監査ログで追跡される S3 処理"