Manage object

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

Available in Classic and VPC

You can upload or download stored objects to and from the bucket you created, and manage them.

Upload object

To upload an object to the created bucket:

1. From the NAVER Cloud Platform console, navigate to Menu > All Services > Storage > Ncloud Storage.
2. Select the bucket to upload object to in the Bucket Management interface.
3. Click [Manage object].
4. Click [Upload file].
5. When the Upload file popup appears, drag and drop the object to add or click [Add file] to 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 saving the object.
     • Standard Class: Suitable for storing data that is frequently accessed.
     • One Zone-IA Class: Data that is not frequently accessed but requires immediate view, and optimized for cost by being stored within a single availability zone.
     • Deep Archive Class: Suitable for long-term archived data that is rarely accessed.
     • Encryption management: Select the encryption type for the object.
       • For more information about how to set encryption, see Encryption configuration.
     • 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 objects in the Manage object interface.

Download object

To download objects stored in a bucket:

1. From the NAVER Cloud Platform console, navigate to Menu > All Services > Storage > Ncloud Storage.
2. Select the bucket to download an object from in the Bucket Management interface.
3. Click [Manage object].
4. Select the object to download from 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 > All Services > Storage > Ncloud Storage.
2. Select the bucket to create a folder to in the Bucket Management interface.
3. Click [Manage object].
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 > All Services > Storage > Ncloud Storage.

2. Select a bucket in the Bucket Management interface.

3. Click [Manage object].

4. Select an object and click [Edit].
   

   Menu name	Description
   Delete/Cancel deletion	Delete or cancel deletion of the selected object.
   Copy/Paste	Copy and paste of the selected object.
   Start restoration	Temporarily restore an object stored in the Deep Archive Class to the Standard Class.
   Check size	Check size of the selected object.
   Rename	Rename the selected object.
   Change storage class	Change the storage class of the selected object.
   Change metadata	Add or delete metadata of the selected object.

Delete/Cancel deletion

You can delete objects stored in the bucket or cancel deletion in progress. 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 file 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 deletion requests for objects whose deletion has not yet started.

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 [Copy].
3. Click [Edit] again and then [Paste].
4. Click [Select location] in the Paste popup.
5. Select the location to store the copied object and click [OK].
6. Click [Change class] to select the storage class to save the copied object to. If not selected, the original object's storage class remains.
7. Click [Start transfer].
8. 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.
     • Change the usage period of the restored object: Select the restored object, click the Edit > Start restoration menu, and then enter the period (expiration date is reset 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 changes to October 14, 2024 at 12:00 AM.

Check size

You can check the size of objects stored in the bucket. To check the size of an object:

1. Select 1 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

You can rename the saved objects. In the console, only objects with a size of 5 GB or less and objects stored in the Standard Class or One Zone-IA 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 Rename.
3. The name input field becomes active in the object list on the Manage object interface.
4. Enter a 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 [Change storage class].
3. When the Change class popup appears, set the storage class.
   • Standard Class: Suitable for storing data that is frequently accessed.
   • One Zone-IA Class: Data that is not frequently accessed but requires immediate view, and optimized for cost by being stored within a single availability zone.
   • 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 [Change metadata].

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	Whether the user edited the value
   Accept-Ranges	Range header	Not available
   ETag	Entity tag representing a specific version of the object	Not available
   Last-Modified	Most recent date of object creation or last modification	Not available
   Content-Length	Object size (in bytes)	Not available
   Content-Type	Object type	Available

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 component.
2. Select the encryption type in the Encryption management popup, then click [OK].
   • NAVER Cloud Platform-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 > All Services > Storage > Ncloud Storage.
2. Select a bucket in the Bucket Management interface.
3. Click [Manage object].
4. Click [Switch bucket].
5. In the Switch bucket popup, select the bucket whose object list is to be viewed.
6. Click [OK].

Show version

Versioning assigns a unique version ID to each version of the same object. Specify the version ID to perform jobs on a specific object version. To view all versions of objects stored in a bucket with versioning enabled:

1. From the NAVER Cloud Platform console, navigate to Menu > All Services > Storage > Ncloud Storage.
2. Select a bucket in the Bucket Management interface.
3. Click [Manage object].
4. Click Show version to show or hide the version ID.
   • To download a certain version: Select the version and click [Download].
   • To delete a certain 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 not turned on, only the latest version of the object is shown. If no version ID is specified, a GET request returns the current object version. To retrieve a specific version of an object, turn on Show version and then specify the version 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 turned 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 a GET request. To delete an object permanently, turn on Show version and specify the version to delete. To cancel deletion of an object, select the version ID of the delete marker to delete. When the delete marker is deleted, the previous version becomes the current version.

Object task for buckets with version management suspended

When versioning is suspended on a bucket, the version ID of any stored object or of objects saved before versioning was enabled is set to NULL. Object jobs for buckets with versioning 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 will not be overwritten. The existing object is maintained as the previous version, and a new object with a NULL version ID becomes the current version.

Retrieve object

Regardless of the versioning 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.