- Print
- PDF
AWS S3 API
- Print
- PDF
Available in Classic and VPC.
This is an example of using NAVER Cloud Platform's Archive Storage using the API provided by AWS S3. This guide is based on the Amazon S3 v2006-03-01 version
- Since the S3 API only supports basic functions, it is recommended to use it only for limited purposes (Get/Listing). You can use Archive Storage in a more stable environment by using the other SDKs or consoles that this guide guides you through.
- The S3 API may behave unstable when managing large objects. If you need to manage large objects, please refer to Large File Management.
Endpoint
Both HTTP/HTTPS protocols are supported, but we recommend using HTTPS protocol for data protection.
Region-specific calling domains are as follows:
Region | Region Name | Calling Domain |
---|---|---|
South Korea | kr | https://kr.archive.ncloudstorage.com |
Region names must be entered in lowercase.
Credential
The API authentication key is used as it is created in NAVER Cloud Platform portal. In API authentication key information, use Access Key ID as user name and Secret Key as user password.
- For more information on how to use operations, see Instruction to the Object Storage API.
- For information on how to generate and verify an API authentication key, refer to Creating and verifying an API authentication key.
Operations
NAVER CLOUD PLATFORM's Archive Storage only provides some S3 APIs. Supported operations are:
Account related operations
At the account level, we only support operations that view the buckets belonging to that account. Account-related operations include:
Operations | Description |
---|---|
GET account | Viewing a list of buckets belonging to an account |
Bucket Operations
Operations to create, delete, view and control buckets include:
Operations | Description |
---|---|
DELETE Bucket | Delete empty buckets |
GET Bucket | View the objects contained in the bucket. Up to 1,000 objects listed at one time |
HEAD Bucket | View bucket header |
GET multipart uploads | Viewing incomplete or canceled multipart uploads |
PUT Bucket | Create a bucket. The number of buckets per account is limited to 1,000 |
Viewing a list of objects in a bucket GET Bucket (List Objects) Version 2 is not supported.
Object operations
The operations for creating, deleting, viewing and controlling objects are as follows:
Operations | Description |
---|---|
DELETE Object | Delete object from bucket |
DELETE Multiple Objects | Delete multipart object from bucket |
GET Object | Viewing an object from a bucket |
HEAD Object | View object Header |
PUT Object | Add object to bucket |
PUT Object (Copy) | Create object copy |
Initiate Multipart Upload | Generate an upload ID to assign to a set of parts to be uploaded |
Upload Part | Part Upload of Object Associated with Upload ID |
Upload Part (Copy) | Upload parts of an existing object associated with the upload ID |
Complete Multipart Upload | Combining objects separated into parts associated with an upload ID |
Abort Multipart Upload | Abort the upload and delete the part associated with the upload ID |
List Parts | Return a list of parts associated with an upload ID |
- In Archive Storage, the directory (folder) object's content-type uses application/directory.
- It is recommended not to use '/' at the end of directory (folder) object names.