PostContainer
  • PDF

PostContainer

  • PDF

Overview

Sets and changes the metadata of containers (buckets).

Statement

POST https://{endpoint}/swift/v1/{containerName}

Request

Request header

Header name Description
x-ncp-apigw-timestamp This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC.
If the time difference compared to the API Gateway server is more than 5 minutes, then the request is considered invalid.
x-ncp-iam-access-key This is the access key ID issued by the NCP portal or Sub Account.
x-ncp-apigw-signature-v2 Signature used to encrypt the body of the above example with the SecretKey that maps with the access key ID.
The HMAC encryption algorithm is HMACSHA256.
x-ncp-region_code The region code of where the bucket of the data to be migrated from another cloud to NAVER Cloud is located

Request parameter

Parameter name Requirement status Type Restrictions Description
ContainerName - string - Name of the container to change

Response

Response header

Name In Type Description
X-Container-Meta-name header string - Metadata information for the container (bucket)
- The name part of the header name serves as the metadata's key.
Content-Length header string Length of the response result (bytes)
X-Container-Object-Count header integer Number of objects in the container (bucket)
X-Container-Bytes-Used header integer Total capacity size used by the container (bucket) (bytes)
X-Container-Meta-Temp-URL-Key (Optional) header string Secret key value for the temporary URL
X-Container-Meta-Temp-URL-Key-2 (Optional) header string Second secret key value for the temporary URL
X-Container-Meta-Quota-Count (Optional) header string Limit for number of objects in the container (bucket)
X-Container-Meta-Quota-Bytes (Optional) header string Capacity limit of the container (bucket)
X-Storage-Policy (Optional) header integer Storage policy value of the container (bucket)
X-Container-Read (Optional) header integer READ ACL of the container (bucket)
X-Container-Write (Optional) header integer WRITE ACL of the container (bucket)
X-Timestamp header integer Creation time of the container (bucket) (Unix time)
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)
Content-Type header string Format of the response result
Date header string Response time of the request (UTC)

Examples

Request examples (JSON)

curl -X POST "https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -H "X-Container-Meta-Access-Control-Allow-Origin: http://localhost" -H "x-ncp-region-code: {regionCode}"
-H "x-ncp-iam-access-key: {AccessKey} " 
-H "x-ncp-apigw-timestamp: {current timestamp}" 
-H "x-ncp-apigw-signature-v2: {generated signature}"

Response examples

HTTP/1.1 204 No_CONTENT
Accept: application/json
connection: keep-alive
Content-Length: 2577
Keep-alive: timeout=60
X-Container-Bytes-Used: 786133
X-Container-Object-Count: 1
X-Timestamp: 1634538594.09393
Content-Type: application/json; charset=utf-8
X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
X-Container-Meta-Access-Control-Allow-Origin: http://localhost
Date: Mon, 18 Apr 2022 11:07:18 GMT

Was this article helpful?

What's Next