Overview
NAVER Cloud Platform Archive Storage provides the OpenStack Swift API for managing and using storage.
Version: 2.15.1 (Pike)
For sub accounts, some APIs are available through an external API Gateway dedicated to sub accounts, rather than through a conventional calling domain.
Common settings
Calling domain (endpoint)
While it supports both HTTP/HTTPS protocols, we recommend using HTTPS for data protection.
URL by Region
| Region | Authentication URL | Service URL |
|---|---|---|
| Korea | https://kr.archive.ncloudstorage.com:5000 | https://kr.archive.ncloudstorage.com |
| Korea | https://archive-storage-external-api.apigw.ntruss.com | https://archive-storage-external-api.apigw.ntruss.com |
Authentication
Archive Storage generates tokens using authentication credentials, and you can use the issued tokens to access the service.
For the user information required to generate tokens, use the API authentication key created by referring to Ncloud API. Use the API authentication key's access key ID as the user name and the secret key as the user password.
The project ID and domain ID information for the user's account can be found by clicking [Check API usage information] after subscribing from the Archive Storage console.
The following describes all the operations you can use when accessing NAVER Cloud Platform's Archive Storage using the OpenStack Swift API. For more information on how to use operations, including samples, see the Bucket operations and Object operations pages.
Request headers
The following describes commonly used request headers in Archive Storage API.
| Headers | Description |
|---|---|
X-Auth-Token |
String |
Response headers
The following describes commonly used response headers in Archive Storage API.
| Field | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | - | MIME type of the response result |
Content-Length |
String | - | Length of the response result (bytes) |
X-Trans-Id |
String | - | Transaction ID of the request |
X-Openstack-Request-Id |
String | - | Transaction ID of the request
|
Date |
String | - | Response time of the request (UTC) |
Operations
Account operations
The following describes operations to get the list of containers (buckets) belonging to an account, get metadata, and get metadata settings.
You can check your account by using a unique project ID, subscribing to the service in the Archive Storage console, and clicking [Check API usage information] .
| Operations | Description |
|---|---|
| GET | Get the list of containers (buckets) that belong to an account. |
| HEAD | Get the metadata for an account. |
| POST | Set or change metadata for an account. |
Container (bucket) operations
The following describes operations that create, delete, view, and control containers (buckets).
| Operations | Description |
|---|---|
| PUT | Create a container (bucket). |
| GET | Get the list of objects that belong to a container (bucket). |
| HEAD | Get the metadata for a container (bucket). |
| POST | Set and change the metadata of a container (bucket). |
| DELETE | Delete empty containers (buckets). |
Object operations
The following describes operations that create, delete, view, and control objects.
| Operations | Description |
|---|---|
| PUT | Upload object Overwrite if there's an object with the same name. |
| COPY | Duplicate an object from another location. |
| GET | Download an object. |
| HEAD | Get the metadata for an object. |
| POST | Set or change metadata for an object. |
| DELETE | Delete an object. |