Manage objects

Available in Classic and VPC

You can easily upload to or download from the created bucket. You can also manage uploaded objects conveniently.

Upload object

To upload an object to the created bucket:

1. From the NAVER Cloud Platform console, navigate to Menu > Services > Storage > Ncloud Storage.
2. Select the bucket to upload object to in the Manage bucket interface.
3. Click [Manage object] to go to the Manage object interface.
4. Click [Upload file].
5. When the file upload popup 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.
   • [Set encryption]: Select the encryption type to apply to the object.
     • For more information about how to set encryption, see Encryption settings (KMS).
   • [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 [Start transfer].
   • [Stop transfer]: Stop the ongoing file upload.
   • Close this window when finished: If checked, the popup automatically closes when file transfer is complete.
8. Click [Close].
9. You can see the uploaded file in the bucket list.

Download object

To download objects stored in a bucket:

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

Create new folder

To create a new folder in the bucket:

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

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 Menu > Services > Storage > Ncloud Storage.

2. Select a bucket in the Manage bucket interface.

3. Click [View] and go to the Manage object interface.

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

   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 deletion tasks in progress can be canceled. To delete or cancel the deletion of an object:

1. Select an object to delete in the object list and click [Edit].
2. After selecting Delete, check the file to be deleted in the delete confirmation popup.
3. Click [Delete], then the selected object is deleted.
   • 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 [Edit].
2. Click the Copy menu.
   • The copied object is stored in the standard class.
3. Click [Edit] again and select the Paste menu.
4. Click [Select location] in the Paste popup.
5. Select the location to store the copied object and click [Start transfer].
6. Click [Close] 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] menu.
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, navigate to 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 12:00 AM has its usage period (days) reset to 1 day on October 12, 2024 at 02:00 PM, the restoration expiration time will change to October 14, 2024 at 12:00 AM.

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 [Edit].
   • 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.

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 [Edit].
2. Click on the Change name menu.
3. The name input field becomes active in the object list on the Manage object 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 [Edit].
2. Click the Change the storage class menu.
3. When the Change class popup 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 [Start transfer].
5. Click [Close] after the transfer completes.

Change metadata

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

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

2. Click the Change metadata menu.

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

   • Add metadata: Enter the keyword and value and click [Add metadata].
   • Edit metadata: Click [Edit] in the same row in the metadata list.
   • Delete metadata: Click [Delete] 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].

Encryption settings

You can change the encryption type of an object either during or after the upload of an object. To change the encryption type of an object:

1. Select an object in the object list and click in the encryption settings area.
2. Select the encryption type in the encryption management popup, then click OK.
   • NCP-managed key (SSE-S3): Data is automatically encrypted on the server using the encryption key managed by Ncloud Storage. You do not need to create or manage keys, as data is automatically encrypted upon storage and decrypted upon access. It is provided as the default encryption type. SSE-S3 is applied if you do not specify the encryption management type.
   • KMS master key (SSE-KMS): Data is encrypted on the server using the keys managed by Key Management Service (KMS).
   • Client-provided encryption key (SSE-C): Data is encrypted on the server using the encryption key provided by the client, and the same key must be provided when an object is accessed. If you want to use client-provided keys for encryption (SSE-C), you can apply it through the API or CLI.

Switch bucket

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

1. From the NAVER Cloud Platform console, navigate to Menu > Services > Storage > Ncloud Storage.
2. Select a bucket in the Manage bucket interface.
3. Click [View] and go to the Manage object interface.
4. Click [Switch bucket].
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 version management enabled:

1. From the NAVER Cloud Platform console, navigate to Menu > Services > Storage > Ncloud Storage.
2. Select a bucket in the Manage bucket interface.
3. Click [View] and go to the Manage object 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 [Download].
   • If you want to delete a specific version, select the version and click [Edit] > Delete.
     • You cannot recover files if all versions are deleted.

Object task for buckets with version management enabled

Object tasks 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 remains in the bucket as the previous version.

Retrieve object

If Show Version is turned off, only the latest version of the object is shown, and a simple GET request without specifying the version ID retrieves the current version of the object. To retrieve a specific version of an object, set Show Version to on and specify the version of the object to download.

Restore previous version

Turn on Show Version 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 Show Version is set to off and the current version of the object is deleted, Ncloud Storage does not permanently delete the object but inserts a delete marker with a new version ID for the object. When the delete marker becomes the current version, an error occurs during the GET request. To permanently delete an object of which version is managed, set Show Version to on 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 overwrites the previous object. However, if the previous current version has a version ID, the object is not overwritten. Instead, the previous version is retained, and a new object with a version ID of null becomes 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 Show Version 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 Show Version and specify the version of the object to delete that version.