ポータルのショートカット NAVERクラウドプラットフォームのマニュアル

コンテナのオペレーション

コンテナ(バケット)及びオブジェクトリストの照会

構文

GET /v1/AUTH_{project_id}/{container}

リクエストの例 (JSON)

curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json

レスポンスの例

HTTP/1.1 200 OK
Content-Length: 352
X-Container-Object-Count: 2
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
X-Storage-Policy: standard01
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 420024
Content-Type: application/json; charset=utf-8
X-Trans-Id: tx6bb706abe32b4ae5a49e8-005b978263
X-Openstack-Request-Id: tx6bb706abe32b4ae5a49e8-005b978263
Date: Tue, 11 Sep 2018 08:52:51 GMT

[
   {
      "hash":"9bd5b4f25faf491080654a34d57c3636",
      "last_modified":"2018-09-11T02:12:29.991410",
      "bytes":210012,
      "name":"ncloud-test-object-0.txt",
      "content_type":"text/plain"
   },
   {
      "hash":"9bd5b4f25faf491080654a34d57c3636",
      "last_modified":"2018-09-11T02:12:29.992600",
      "bytes":210012,
      "name":"ncloud-test-object-1.txt",
      "content_type":"text/plain"
   }
]

リクエストの例 (XML)

curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=XML

レスポンスの例

HTTP/1.1 200 OK
Content-Length: 520
X-Container-Object-Count: 2
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
X-Storage-Policy: standard01
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 420024
Content-Type: application/xml; charset=utf-8
X-Trans-Id: txfff4e8574d7e43f38b8e8-005b9782ef
X-Openstack-Request-Id: txfff4e8574d7e43f38b8e8-005b9782ef
Date: Tue, 11 Sep 2018 08:55:11 GMT

<?xml version="1.0" encoding="UTF-8"?>
<container name="ncloud-container-0">
   <object>
      <name>ncloud-test-object-0.txt</name>
      <hash>9bd5b4f25faf491080654a34d57c3636</hash>
      <bytes>210012</bytes>
      <content_type>text/plain</content_type>
      <last_modified>2018-09-11T02:12:29.991410</last_modified>
   </object>
   <object>
      <name>ncloud-test-object-1.txt</name>
      <hash>9bd5b4f25faf491080654a34d57c3636</hash>
      <bytes>210012</bytes>
      <content_type>text/plain</content_type>
      <last_modified>2018-09-11T02:12:29.992600</last_modified>
   </object>
</container>

リクエストが成功したら、OK (200)、No Content (204)のステータスコードをレスポンスします。 No Content (204)である場合は、Content-Typeがplainであり、リクエストに該当する内容がない場合に発生します。 コンテナ(バケット)が存在しない場合は、Not Found (404)のステータスコードをレスポンスします。

リクエストのパラメータ

レスポンスのパラメータ

コンテナ(バケット)の生成

構文

PUT /v1/AUTH_{project_id}/{container}

リクエストの例 (コンテナの生成)

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

レスポンスの例

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

リクエストの例 (コンテナの生成、メタデータを含む)

curl -i -X PUT -H "X-Auth-Token: $token" -H "X-Container-Meta-Book: ncloud-book" -H "X-Container-Meta-Subject: ncloud-test-subject" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}

レスポンスの例

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を含む)

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

レスポンスの例

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

リクエストが成功したら、Created (201), Accepted (202)のステータスコードをレスポンスします。 Accepted (202)である場合は、既に該当のコンテナ(バケット)が存在し、メタデータなどを変更する際に発生します。 コンテナ(バケット)が存在しない場合は、Not Found (404)のステータスコードをレスポンスします。

リクエストのパラメータ

レスポンスのパラメータ

コンテナ(バケット) メタデータの設定

構文

POST /v1/AUTH_{project_id}/{container}

リクエストの例 (コンテナ メタデータの生成)

curl -i -X POST -H "X-Container-Meta-Book: ncloud-book" -H "X-Container-Meta-Subject: ncloud-test-subject" -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}

レスポンスの例

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txefe14b178c56469b8576f-005b987d66
X-Openstack-Request-Id: txefe14b178c56469b8576f-005b987d66
Date: Wed, 12 Sep 2018 02:43:50 GMT

リクエストの例 (コンテナ メタデータのアップデート)

curl -i -X POST -H "X-Container-Meta-Book: ncloud-book2" -H "X-Container-Meta-Subject: ncloud-test-subject2" -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}

レスポンスの例

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx66932a917b854a458544a-005b987d78
X-Openstack-Request-Id: tx66932a917b854a458544a-005b987d78
Date: Wed, 12 Sep 2018 02:44:08 GMT

リクエストの例 (コンテナ メタデータの削除)

curl -i -X POST -H "X-Remove-Container-Meta-Book: x" -H "X-Remove-Container-Meta-Subject: x" -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}

レスポンスの例

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx590d9493661147e780d99-005b987df5
X-Openstack-Request-Id: tx590d9493661147e780d99-005b987df5
Date: Wed, 12 Sep 2018 02:46:13 GMT

リクエストが成功すれば、No Content (204)のステータスコードをレスポンスします。

リクエストのパラメータ

レスポンスのパラメータ

コンテナ(バケット)メタデータの照会

構文

HEAD /v1/AUTH_{project_id}/{container}

リクエストの例 (コンテナメタデータの照会)

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

レスポンスの例

HTTP/1.1 204 No Content
Content-Length: 0
X-Container-Object-Count: 3
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 630036
Content-Type: text/plain; charset=utf-8
X-Trans-Id: tx51f8478e8e924403851a4-005b988014
X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
Date: Wed, 12 Sep 2018 02:55:16 GMT

リクエストに成功すれば、No Content (204) のステータスコードをレスポンスします。

リクエストのパラメータ

レスポンスのパラメータ

コンテナ(バケット)の削除

構文

DELETE /v1/AUTH_{project_id}/{container}

リクエストの例

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

レスポンスの例

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx762d33b115e748a29fb6e-005b98975b
X-Openstack-Request-Id: tx762d33b115e748a29fb6e-005b98975b
Date: Wed, 12 Sep 2018 04:34:35 GMT

リクエストに成功すれば、No Content (204) のステータスコードをレスポンスします。

リクエストのパラメータ

レスポンスのパラメータ