Swift コンテナーの作成

新規コンテナーを作成するには、API バージョン、アカウント、および新規コンテナーの名前を使用して PUT 要求を行います。 コンテナー名は固有でなければならず、スラッシュ (/) 文字を含んでいてはならず、256 バイト未満でなければなりません。 アクセス制御ヘッダーとメタデータ・ヘッダーを要求に含めることができます。 また、一連の配置プールのキーを識別するストレージ・ポリシーを組み込むこともできます。 例えば、 radosgw-admin zone get を実行すると、 placement_poolsの下に使用可能なキーのリストが表示されます。 ストレージ・ポリシーを使用すると、SSD ベースのストレージなど、コンテナー用の特殊なプール・セットを指定できます。 操作はべき等です。 すでに存在するコンテナを作成するようリクエストした場合、 HTTP 202 のリターンコードで応答しますが、別のコンテナは作成されません。

構文

PUT /_AP_VERSION_/_ACCOUNT_/_TENANT_:_CONTAINER_ HTTP/1.1
Host: FULLY_QUALIFIED_DOMAIN_NAME
X-Auth-Token: _AUTH_TOKEN_
X-Container-Read: _COMMA_SEPARATED_UIDS_
X-Container-Write: _COMMA_SEPARATED_UIDS_
X-Container-Meta-_KEY_:VALUE
X-Storage-Policy: _PLACEMENT_POOLS_KEY_

ヘッダー

X-Container-Read

説明

コンテナーの読み取り権限を持つユーザー ID。

タイプ

ユーザー ID のコンマ区切りストリング値。

必須

いいえ

X-Container-Write

説明

コンテナーに対する書き込み権限を持つユーザー ID。

タイプ

ユーザー ID のコンマ区切りストリング値。

必須

いいえ

X-Container-Meta-_KEY

説明

任意のストリング値を取るユーザー定義のメタデータ・キー。

タイプ

ストリング

必須

いいえ

X-Storage-Policy

説明

Ceph Object Gatewayの placement_pools でストレージ・ポリシーを識別するキー。 使用可能な鍵については、 radosgw-admin zone get を実行してください。

タイプ

ストリング

必須

いいえ

同じ名前のコンテナーが既に存在し、ユーザーがコンテナー所有者である場合、操作は成功します。 そうしないと、操作は失敗します。

HTTP 応答

409

状況コード

BucketAlreadyExists

説明

コンテナーは別のユーザーの所有権の下に既に存在します。