コンテナの処理

コンテナに対して実行するSwift API処理を次に示します。

StorageGRID Webscaleシステムでは、1つのSwiftアカウントにつき最大で1000個のコンテナがサポートされます。
処理 実装
DELETE(コンテナ)

StorageGRID WebscaleシステムのSwiftアカウントから空のコンテナを削除します。

次の要求パラメータが必要です。

  • Account
  • Container

次の要求ヘッダーが必要です。

  • X-Auth-Token

実行が成功すると、「HTTP/1.1 204 No Content」の応答とともに次のヘッダーが返されます。

  • Content-Length
  • Content-Type
  • Date
  • X-Trans-Id
GET(コンテナ)

コンテナに関連付けられているオブジェクト リストを、StorageGRID Webscaleシステム内のコンテナの統計情報およびメタデータとともに読み出します。

次の要求パラメータが必要です。
  • Account
  • Container

次の要求ヘッダーが必要です。

  • X-Auth-Token

次のサポートされる要求クエリ パラメータはオプションです。

  • Delimiter
  • End_marker
  • Format
  • Limit
  • Marker
  • Path
  • Prefix

実行が成功すると、「HTTP/1.1 200 Success」または「HTTP/1.1 204 No Content」の応答とともに次のヘッダーが返されます。

  • Accept-Ranges
  • Content-Length
  • Content-Type
  • Date
  • X-Container-Bytes-Used
  • X-Container-Object-Count
  • X-Timestamp
  • X-Trans-Id

Keystoneを有効にした設定でこの処理を設定すると、次のヘッダーが管理ユーザに返されます。

  • X-Container-Read
  • X-Container-Write
注:デフォルトではKeystoneは無効に設定されます。Keystoneを有効にする場合は、ネットアップの担当者にお問い合わせください。
HEAD(コンテナ)

StorageGRID Webscaleシステムからコンテナの統計情報とメタデータを読み出します。

次の要求パラメータが必要です。

  • Account
  • Container

次の要求ヘッダーが必要です。

  • X-Auth-Token

実行が成功すると、「HTTP/1.1 204 No Content」の応答とともに次のヘッダーが返されます。

  • Accept-Ranges
  • Content-Length
  • Date
  • X-Container-Bytes-Used
  • X-Container-Object-Count
  • X-Timestamp
  • X-Trans-Id

Keystoneを有効にした設定でこの処理を設定すると、次のヘッダーが管理ユーザに返されます。

  • X-Container-Read
  • X-Container-Write
注:デフォルトではKeystoneは無効に設定されます。Keystoneを有効にする場合は、ネットアップの担当者にお問い合わせください。
POST(コンテナ)

Keystoneが設定されたStorageGRID Webscaleシステムで、管理ユーザが既存のコンテナのACLメタデータの作成、変更、または削除を行います。

注:この処理は、Swift Keystoneアカウントでのみサポートされます。デフォルトではKeystoneは無効に設定されます。Keystoneを有効にする場合は、ネットアップの担当者にお問い合わせください。

Keystoneが無効になっている(デフォルト)場合は、この処理に対して「Not Implemented」のステータスが返されます。

次の要求パラメータが必要です。

  • Account
  • Container

次の要求ヘッダーが必要です。

  • X-Auth-Token

次の要求ヘッダーはオプションです。

  • X-Container-Read
  • X-Container-Write
  • X-Remove-Container-Read
  • X-Remove-Container-Write
注:これ以外のメタデータ処理はサポートされず、実行しても無視されます。

実行が成功すると、「HTTP/1.1 204 No Content」の応答とともに次のヘッダーが返されます。

  • Content-Length
  • Date
  • X-Timestamp
  • X-Trans-Id
PUT(コンテナ)

StorageGRID Webscaleシステムのアカウントにコンテナを作成します。

次の要求パラメータが必要です。

  • Account
  • Container

次の要求ヘッダーが必要です。

  • X-Auth-Token

実行が成功すると、「HTTP/1.1 201 Created」または「HTTP/1.1 202 Accepted」の応答(このアカウントにコンテナがすでに存在する場合)とともに次のヘッダーが返されます。

  • Content-Length
  • Date
  • X-Timestamp
  • X-Trans-Id

コンテナ名はStorageGRID Webscaleネームスペース内で一意である必要があります。このコンテナが別のアカウントの下に存在する場合は、ヘッダー「HTTP/1.1 409 Conflict」が返されます。

次のヘッダーはオプションで、Keystoneを有効にした設定で管理ユーザに対してのみサポートされます。

  • X-Container-Read
  • X-Container-Write
  • X-Remove-Container-Read
  • X-Remove-Container-Write
注:この処理は、Swift Keystoneアカウントでのみサポートされます。デフォルトではKeystoneは無効に設定されます。Keystoneを有効にする場合は、ネットアップの担当者にお問い合わせください。