PutContainer

Prev Next

Classic/VPC環境で利用できます。

コンテナ(バケット)を作成します。

参考

Subaccountの場合、Subaccount専用の External API Gatewayを通じて使用できます。
詳細は、SubAccountのPutContainer APIをご参照ください。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
PUT /v1/AUTH_{project_id}/{container}

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド タイプ 必須の有無 説明
X-Auth-Token String Required 発行したトークン(Token)の値
X-Container-Read String Optional コンテナ(バケット)の READ ACL(アクセス権限)
X-Container-Write String Optional コンテナ(バケット)の WRITE ACL(アクセス権限)
X-Container-Sync-Key String Optional 使用しない
X-Container-Sync-To String Optional 使用しない
X-Versions-Location String Optional 使用しない
X-History-Location String Optional 使用しない
X-Container-Meta-name String Optional コンテナ(バケット)のメタデータ
  • ヘッダ名のname部分がメタデータのキーの役割を果たす
  • 追加、アップデート、削除が可能で、削除は空の値でリクエスト
X-Container-Meta-Access-Control-Allow-Origin String Optional CORS設定
  • アクセス可能なソースドメイン
X-Container-Meta-Access-Control-Max-Age String Optional CORS設定(秒)
  • 結果をキャッシュできる最大時間
X-Container-Meta-Access-Control-Expose-Headers String Optional CORS設定
  • 公開はされないが、アクセスを許可するヘッダ
X-Container-Meta-Quota-Bytes String Optional コンテナ(バケット)の容量制限値
X-Container-Meta-Quota-Count String Optional コンテナ(バケット)のオブジェクト数の制限値
X-Container-Meta-Temp-URL-Key String Optional temporary URLのための Secret Key値
X-Container-Meta-Temp-URL-Key-2 String Optional temporary URLのための2番目の Secret Key値

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
project_id String Required プロジェクト ID
container String Required 作成するコンテナ(バケット)の名前

リクエスト例

リクエストのサンプルコードは次の通りです。

コンテナ(バケット)の作成リクエスト

コンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

curl -X PUT "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}" 
-H "X-Auth-Token: $token"

メタデータを含むコンテナ(バケット)の作成リクエスト

メタデータを含むコンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Container-Meta-{name}: $container-metadata-string"

ACLを含むコンテナ(バケット)の作成リクエスト

ACLを含むコンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Container-Read: .r:*

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

Archive Storage APIで共通して使用されるレスポンスヘッダの詳細は、Archive Storageの共通レスポンスヘッダをご参照ください。

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
200 - OK リクエスト成功
204 - No Content Content-Typeがplainで、リクエストに該当する内容がない場合に発生
403 - Not Found コンテナ(バケット)が存在しない場合に発生

レスポンス例

レスポンスのサンプルコードは次の通りです。

コンテナの作成をリクエストした場合のレスポンス

コンテナの作成をリクエストした場合、レスポンスのサンプルコードは次の通りです。

HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txa8b5404ac864437293727-005b9878d1
X-Openstack-Request-Id: txa8b5404ac864437293727-005b9878d1
Date: Wed, 12 Sep 2018 02:24:17 GMT

メタデータを含むコンテナの作成をリクエストした場合のレスポンス

メタデータを含むコンテナの作成をリクエストした場合、レスポンスのサンプルコードは次の通りです。

HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx8282719a30554e2b8e0c7-005b987946
X-Openstack-Request-Id: tx8282719a30554e2b8e0c7-005b987946
Date: Wed, 12 Sep 2018 02:26:14 GMT

ACLを含むコンテナの作成をリクエストした場合のレスポンス

ACLを含むコンテナの作成をリクエストした場合、レスポンスのサンプルコードは次の通りです。

HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx691a8ed48a3f4152ae904-005b98799c
X-Openstack-Request-Id: tx691a8ed48a3f4152ae904-005b98799c
Date: Wed, 12 Sep 2018 02:27:41 GMT