PutContainer
  • PDF

PutContainer

  • PDF

Overview

Creates containers (buckets).

Statement

PUT 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 create

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-Storage-Policy (Optional) header integer Storage policy value 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 PUT " https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -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 201 CREATED
Accept: application/json
connection: keep-alive
Content-Length: 0
X-Container-Bytes-Used: 0
X-Container-Object-Count: 0
X-Timestamp: 1634538594.09393
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