Object management

Available in Classic and VPC

Objects can be easily uploaded or downloaded to the created bucket. Uploaded objects can also be managed conveniently.

Object upload

To upload an object to the created bucket:

1. From the NAVER Cloud Platform console, navigate to > Services > Storage > Ncloud Storage.
2. Select the bucket to upload object to in the Bucket management interface.
3. Click the [Object management] button to move to the Object management interface.
4. Click the [Upload file] button.
5. When the Upload popup window appears, drag and drop the object to add or click [Add file] and select the file.
   • Object names can be specified using Unicode characters with a maximum length of 1,024 bytes (including the prefix) in UTF-8 encoding.
   • Up to 100 objects can be uploaded at once via file upload.
   • Each object uploaded via file upload can be up to 5 GB.
     • Objects larger than 5 GB can be uploaded via APIs, up to a maximum of 5 TB.
6. You can configure options for object storage as necessary.
   • [Select location]: You can change the bucket or change the storage location in the bucket.
   • [Change class]: Select the storage class for storing the object.
     • Standard Class: Storage for data that is accessed frequently and requires fast access.
     • Deep Archive Class: Storage for data that is rarely accessed over a long period and where low storage cost is a priority.
   • [Settings]: Set the metadata management value for the object.
     • System metadata: Select system metadata keywords defined in the system and enter values.
     • User metadata: Set custom metadata keywords and enter values.
7. Click the [Start transfer] button.
   • [Stop transfer]: Stop the ongoing file upload.
   • Close this window when finished: If checked, the popup window will automatically close when file transfer is complete.
8. Click the [Close] button.
9. You can see the uploaded file in the bucket list.

Object download

To download objects stored in a bucket:

1. From the NAVER Cloud Platform console, navigate to > Services > Storage > Ncloud Storage.
2. Select the bucket to download an object from in the Bucket management interface.
3. Click the [View] button and go to the Object management interface.
4. Select the object to download in the list and click the [Download] button.
5. The selected object will be downloaded to the local environment.

Create a new folder

To create a new folder in the bucket:

1. From the NAVER Cloud Platform console, navigate to > Services > Storage > Ncloud Storage.
2. Select the folder to create a file to in the Bucket management interface.
3. Click the [View] button and go to the Object management interface.
4. Click [New folder].
5. Enter the folder name in the new folder popup window.
   • The folder name, including the object names stored in the folder, cannot exceed 1,024 bytes.
6. Click the [Save] button.

Edit object

Ncloud Storage provides various features for managing stored objects. Some features may have limitations depending on the storage class in which the object is stored.

1. From the NAVER Cloud Platform console, navigate to > Services > Storage > Ncloud Storage.

2. Select a bucket in the bucket management interface.

3. Click the [View] button and go to the Object management interface.

4. Select an object in the object list and click the [Edit] button.
   

   Menu name	Description
   	Delete/cancel deletion
   	Copy/paste
   	Start restoration
   	File size
   	Rename
   	Change storage class
   	Change metadata

Delete/cancel deletion

Objects stored in the bucket can be deleted, or ongoing deletion tasks can be canceled. To delete or undo the deletion of an object:

1. Select an object to delete in the object list and click the [Edit] button.
2. After selecting Delete, check the files to be deleted in the delete confirmation popup window.
3. Clicking the [Delete] button deletes the selected object(s).
   • Cancel deletion is only enabled from the edit menu when deletion is in progress.
   • Clicking Cancel deletion cancels the delete requests for objects before the deletion process began.

Copy/paste

An object can be copied and pasted into a specific folder within the same bucket or into another bucket owned by the user. In the console, only objects with a size of 5 GB or less can be copied, and objects stored in the deep archive class can only be copied after restoration.

1. Select an object to copy in the object list and click the [Edit] button.
2. Click the Copy menu.
   • The copied object is stored in the standard class.
3. Click the [Edit] button again and select the Paste menu.
4. Click the [Select location] button in the Paste popup window.
5. Select the location to store the copied object and click the [Start transfer] button.
6. Click the [Close] button after the transfer completes.

Start restoration

To access an object stored in the deep archive class, the object must be restored to the standard class. To restore an object:

1. Select the object to restore in the object list and click [Edit].
2. Click the [Start restoration].
3. Enter the duration for which the restored copy will be stored.
   • The duration can be specified from 1 day to 3650 days.
4. Select an object and check the necessary information in details.
   • Restoration status: You can access the object once the status changes to Restored.
   • Restoration expiration time: Restored copies are automatically deleted when it reaches the restoration expiration time. (The existing object stored in the Deep Archive Class will be retained.)
     • The restoration expiration time is calculated based on the time the restoration is completed.
     • To change the access period of the restored object, select the restored object, click the Edit > Start restoration menu, and enter the duration to reset the expiration date based on the entered date.
       • Example: If an object with a restoration expiration time set to October 16, 2024 at 00:00 has its usage period (days) reset to 1 day on October 12, 2024 at 14:00, the restoration expiration time will change to October 14, 2024 at 00:00.

File size

The size of objects stored in the bucket can be checked. To check the size of an object:

1. Select one or more objects from the object list to check the size, then click the [Edit] button.
   • Folders do not support size checking feature.
2. Click the Check size menu.
3. Check the size of the selected object in the Check size popup window.

Rename

The name of the stored object can be changed. In the console, only objects with a size of 5 GB or less and objects stored in the standard class can have their names changed. To rename an object:

1. Select an object to rename in the object list and click the [Edit] button.
2. Click on the Change name menu.
3. The name input field becomes active in the object list on the Object management interface.
4. Enter the new name and press the Enter key.

Change storage class

Ncloud Storage provides storage classes that can be selected based on the access frequency and required performance of the object. By selecting the storage class that suits your purpose, you can optimize the cost, performance, and availability of the object. To change the storage class of an object:

1. Select one or more objects from the object list, then click the [Edit] button.
2. Click the Change the storage class menu.
3. When the Change class popup window appears, set the storage class.
   • Standard Class: Suitable for storing data that is frequently accessed.
   • Deep Archive Class: Suitable for long-term archived data that is rarely accessed.
4. Click the [Start transfer] button.
5. Click the [Close] button after the transfer completes.

Change metadata

Objects can have their metadata set either during or after the upload. To add or delete metadata of an object:

1. Select an object in the object list and click the [Edit] button.

2. Click the Change metadata menu.

3. In the Metadata management popup window, set the metadata of the selected file.

   • Add metadata: Enter the keyword and value and click the [Add metadata] button.
   • Edit metadata: Click the [Edit] button in the same row in the metadata list.
   • Delete metadata: Click the [Delete] button in the same row in the metadata list.

   Keyword	Description	User's ability to edit values
   	Accept-Ranges	Range header
   	ETag	Entity tag representing a specific version of the object
   	Last-Modified	Most recent date of object creation or last modification
   	Content-Length	Object size (in bytes)
   	Content-Type	Object type

4. Click [Settings].

Switch bucket

If you want to view the object list of another bucket in the console, you can switch the bucket within the Object management interface. To switch a bucket:

1. From the NAVER Cloud Platform console, navigate to > Services > Storage > Ncloud Storage.
2. Select a bucket in the Bucket management interface.
3. Click the [View] button and go to the Object management interface.
4. Click the [Switch bucket] button.
5. In the Bucket switch popup, select the bucket whose object list is to be viewed.
6. Click [OK].

Show version

Using version management, a unique version ID is assigned to different versions of the same object, and you can perform object task by specifying a specific version ID. To view all versions of objects stored in a bucket with versioning enabled:

1. From the NAVER Cloud Platform console, navigate to > Services > Storage > Ncloud Storage.
2. Select a bucket in the Bucket management interface.
3. Click the [View] button and go to the Object management interface.
4. Click Show version to show or hide the version ID.
   • If you want to download a specific version, select the version and click the [Download] button.
   • If you want to delete a specific version, select the version and click [Edit] > Delete.
     • You cannot restore files if all versions are deleted.

Object task for buckets with version management enabled

Object task in a bucket with version management enabled are as follows.

Add object

If an object with the same name is added, a new version ID is created, and the newly added object becomes the latest current object. The previously stored object will remain in the bucket as the previous version.

Retrieve object

If version display is turned off, only the latest version of the object will be shown, and a simple GET request without specifying the version ID will retrieve the current version of the object. To retrieve a specific version of an object, set on for the version display and specify the desired version of the object to download.

Restore previous version

Turn on version display and copy the previous version of the object to the same bucket. The copied object will become the current version of the object and can be restored. Alternatively, the current object version (latest version) can be deleted, making the previous version the current version.

Delete object

If version display is set off and the current version of the object is deleted, Ncloud Storage will not permanently delete the object but will insert a delete marker with a new version ID for the object. When the delete marker becomes the current version, an error will occur during the GET request. To permanently delete an object of which version is managed, set on for the version and specify the version of the object to delete. To cancel object deletion, select the version ID of the delete marker and delete it. This will remove the delete marker and restore the previous version as the current version.

Object task for buckets with version management suspended

After suspending version management for a bucket with versioning enabled, the version ID of objects stored before version management was set or after version management is suspended are stored as null. Object task for buckets with version management suspended are as follows.

Add object

If an object with a version ID of null is the current version, adding an object with the same name will overwrite the previous object. However, if the previous current version has a version ID, the object will not be overwritten. Instead, the previous version will be retained, and a new object with a version ID of null will become the current version.

Retrieve object

Regardless of the version management setting, the current version of the object is returned.

Delete object

When version management is suspended, objects with a version ID of null can only be deleted with versioning turned off. When an object with a version ID is the current version, a delete marker with a version ID of null is inserted, and this delete marker becomes the current version of the object. If a specific version of an object needs to be deleted, turn on version display and specify the version of the object to delete that version.