コンテナ作成 PUT /v1/{account}/{container}
コンテナを作成する
PUT操作を行う前に、既に同名のコンテナが作成されているか確認する必要はありません。既存のコンテナがなければ新規に作成します。同名のコンテナが存在していれば更新します。
コンテナの新規作成に成功した場合は201が返却されます。コンテナの更新に成功した場合は202が返却されます。
Request Headers
X-Auth-Token
認証トークン
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Container-Read
リード権限のACLを設定します。詳細は、リード権限をご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Write
ライト権限のACLを設定します。詳細は、ライト権限をご参照ください。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Versions-Location
コンテナ内オブジェクトのバージョニングを有効にします。値には他のコンテナ名を設定します。その際、コンテナ名はUTF-8エンコーディングをした上でURLエンコーディングされたものが設定されなければなりません。バージョニングを無効にするには本ヘッダーの値を空にして設定します。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-name
コンテナメタデータ。{name}はメタデータ項目の名前。
| Data Type | Cardinality |
|---|---|
| String | 0..* |
X-Container-Meta-Web-Index
Indexファイルのオブジェクト名を設定します。例えばindex.htmlを設定するとIndexページは/{container}/index.htmlとなります。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Error
Errorページファイルのオブジェクト名を設定します。例えば、error.htmlを設定すると、401エラーは/{container}/401error.html，404エラーは/{container}/404error.htmlオブジェクトとなります。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Listing
TRUEを設定すると、ディレクトリ一覧表示が有効になります。セキュリティ確保のために、通常は設定しないでください。
| Data Type | Cardinality |
|---|---|
| Boolean | 0..1 |
X-Container-Meta-Web-Listing-CSS
ディレクトリ一覧表示用のスタイルシートのオブジェクト名を設定します。例えば、lists.cssを設定すると、/{container}/lists.cssオブジェクトがスタイルシートとして使われます。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Request Parameter
{account}
プロジェクト単位でユニークに割り当てられる名前
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{container}
コンテナ名
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Response Headers
Content-Length
レスポンスボディのバイト数
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Content-Type
レスポンスボディのMIMEタイプ。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Trans-Id
このリクエストに付与されるID。トラブルについて問い合わせる際に利用されます。
| Data Type | Cardinality |
|---|---|
| Uuid | 1..1 |
Date
トランザクションの実行された日付と時間
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
Response Elements
特にありません。
メタデータを設定しない場合
Example of Request
curl -i $publicURL/steven -X PUT -H "Content-Length: 0" -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx7f6b7fa09bc2443a94df0-0052d58b56
Date: Tue, 14 Jan 2014 19:09:10 GMT
メタデータを設定する場合
Example of Request
curl -i $publicURL/steven -X PUT -H "Content-Length: 0" -H "X-Auth-Token: $token" -H "X-Container-Meta-Book: TomSawyer"
Example of Response
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx06021f10fc8642b2901e7-0052d58f37
Date: Tue, 14 Jan 2014 19:25:43 GMT