PostContainer
  • PDF

PostContainer

  • PDF

Overview

Sets and updates metadata of a container (bucket).

Caution

The sub accounts can use it through the external API Gateway dedicated to sub accounts.
Please refer to the sub accounts for more information.

Syntax

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

Request

Name In Type Description
project_id path string Project ID
container path string Container (bucket) name
X-Auth-Token (Optional) header string Token
X-Container-Read (Optional) header string READ ACL of the container
X-Container-Write (Optional) header string WRITE ACL of the container
X-Container-Sync-Key (Optional) header string Not supported
X-Container-Sync-To (Optional) header string Not supported
X-Versions-Location (Optional) header string Not supported
X-History-Location (Optional) header string Not supported
X-Remove-Versions-Location (Optional) header string Not supported
X-Remove-History-Location (Optional) header string Not supported
X-Container-Meta-name (Optional) header string Sets metadata of the container (bucket). The name part in the header name functions as a key of the metadata.
X-Remove-Container-name (Optional) header string Deletes metadata of the container (bucket). The name part in the header name functions as a key of the metadata. X-Remove-Container-Read or X-Remove-Container-Meta-name
X-Container-Meta-Access-Control-Allow-Origin (Optional) header string CORS
X-Container-Meta-Access-Control-Max-Age (Optional) header string CORS
X-Container-Meta-Access-Control-Expose-Headers (Optional) header string CORS
X-Container-Meta-Quota-Bytes (Optional) header string Storage limit of the container (bucket) in bytes. The container (bucket) usage is limited if the storage limit is exceeded.
X-Container-Meta-Quota-Count (Optional) header string Maximum number of objects in the container (bucket)
X-Container-Meta-Temp-URL-Key (Optional) header string Secret key for the temporary URL
X-Container-Meta-Temp-URL-Key-2 (Optional) header string Second secret key for the temporary URL

Response

Name In Type Description
Date header string Response time of the request (in UTC)
X-Timestamp header integer The time when the container (bucket) was created (in UNIX Time)
Content-Length header string Length of the response result (in bytes)
Content-Type (Optional) header string MIME type of the response result
X-Trans-Id header string Transaction ID of the request
X-Openstack-Request-Id header string Transaction ID of the request (same as X-Trans-Id)

Examples

Request example (Create container metadata)

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}

Response example

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

Request example (Update container metadata)

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}

Response example

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

Request example (Delete container metadata)

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}

Response example

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

It returns No Content (204) status code if successful.


Was this article helpful?

What's Next