Manage object/file

Here's how to manage objects and files in the bucket of Object Storage.

View object list

You can view the list of objects created in the current bucket and their basic information.

1. Go to Beyond Storage Service > Object Storage in the KakaoCloud Console.
2. Select a bucket in the Bucket menu.
3. Check the currently created objects in the Objects tab.

Search object

Object filters allow you to search for specific objects, providing object name and absolute path methods.
Object filters can only be single-specified, and if you search with an object filter, the search filter will remain on refresh. The search results are maintained even if you move inside the folder or click Back in the results output by the search filter.

1. Go to Beyond Storage Service > Object Storage in the KakaoCloud Console.

2. In the Bucket menu, select the bucket to retrieve objects.

3. On the Objects tab, under Object filter, select Object name or Absolute path. Then, type the Prefix search term or path to the object and press Enter.

   Category	Description
   Absolute path	An absolute path that is independent of the user's current location
   Object name	Name of the object to search - All objects with the search term as a prefix are displayed as search results
   Go back	Move based on user history rather than upper layer

Upload file

In Object Storage, files are stored in the form of objects (Key-Value structure) and are included in a bucket, a container that can hold objects. Here's how to upload files (objects) to a bucket in Object Storage:

Create folder (optional)

If you want to manage files by folder, you can create a folder.

1. Go to Beyond Storage Service > Object Storage in the KakaoCloud Console.

2. Select a bucket in the Bucket menu.

3. In the Objects tab, click the [Create folder] button.

4. Enter information in the pop-up window and click the [Create] button.

Upload file

You can upload files to your bucket.

- Maximum number of files that can be uploaded at once: 1,000
- Single file capacity that can be uploaded at one time: 50 GB
- Maximum number of files transferred simultaneously: 5
- If the file size is over 100MB, SLO multipart upload is performed.
- Resume function is not provided.

info

Objects that have not been uploaded successfully or are damaged can only be deleted.
Multipart upload objects can use all functions except name modification, copy, and move.

caution

If you upload a file with the same name but a different capacity by overwriting, segment files may remain. We recommend that you delete the existing file and then re-upload it.

1. Go to Beyond Storage Service > Object Storage in the KakaoCloud Console.

2. Select a bucket in the Bucket menu.

3. In the Objects tab, click the [Upload file] button.

4. Click the [Add file]/[Add folder] button to upload the object.

5. Complete object upload and settings, click the [Upload] button.

   Upload file

   Category	Description	Description
   ① Add object	[Add file] button	Upload individual files
   	[Add folder] button	Upload by folder - All subfiles in the selected folder are uploaded
   ⓶ Object settings	File	List of files to upload
   	Metadata (Optional)	When setting metadata for an object, click the [Add metadata] button and enter the type, key, and value - Refer to Set metadata. - Type: Specifies the metadata type   ᄂ System defined: Passing information about objects to Object Storage   ᄂ User defined: Classifies the object as desired by the user arbitrarily changing the key - Key: Unique identifier to recognize the file - Value: Value for the selected key
   	Object tag (Optional)	Each tag is a key-value pair. - Key: Key to distinguish object tags - Value: Value for the selected key
   	Duplicate processing	Set options for handling duplicates for objects - Skip: Do not upload duplicate objects - Overwrite: Overwrite duplicate objects
   	More option	When the checkbox is selected, File upload is automatically closed when file upload is finished

caution

Objects larger than 100MB in size do not support adding tags when uploaded. Please tag objects separately after upload is complete. (Set object tag)

More features

You can perform various management activities on objects through the More menu.

1. Go to Beyond Storage Service > Object Storage in the KakaoCloud Console.
2. Select a bucket in the Bucket menu.
3. After checking the object to be managed in the Objects tab, you can perform the settings and management tasks in the [More] icon.

Set metadata

Metadata is divided into System definition, which is used to convey information about objects to the Object Storage system, and user definition, which users can register arbitrarily. The system definition has a fixed key that can be selected and can be used when specifying the MIME type or compression method of the file. User definition allows the user to change the key name at will, and can be added and used arbitrarily when the user classifies files or implements file management functions according to conditions.

1. In the Objects tab, select the [More] icon > Set metadata of the object to set meta data.

2. In the metadata settings screen, enter Type, Key, and Value and click the Save button.

   Category	Description
   Type	Specify the metadata type by selecting System defined/User defined - System defined (System metadata): A metadata type that is automatically specified when uploading a file. The key value is not modifiable, and only the value can be entered. - User defined (User metadata): A metadata type that allows users to register by arbitrarily specifying a Key-Value value.
   Key	Unique identifier to recognize the file. When Type is selected as System defined: - content-type: Specify the MIME type of the object. - content-disposition: Specify override behavior for the browser. - content-encoding: Specify the algorithm by which encoding is performed. - cache-control: Set cache policy between server and browser. - content-language: Specify the user's desired language When Type is selected as User defined: Depending on the protocol, the prefix of the metadata included in the header may change. - X-Object-Meta-{key_name}: For Swift bucket meta information, enter the metadata key to be specified by the user in {key_name}. - X-Amz-Meta-{key_name}: For S3 bucket meta information, enter the metadata key to be specified by the user in {key_name}.
   Value	Value for the selected key.
   [Trash] icon	Delete the corresponding metadata when clicked.

Set object tag

You can classify objects by assigning tags. Object tags are divided into a key and a value for the key, and are a key-value pair. You can upload new objects or add tags to existing objects. Up to 10 tags can be linked and must have a unique key.

1. In the Objects tab, select the [More] icon > Set object tag of an object.

2. Enter Key and Value and click the Save button.

   Category	Description
   Key	Key to distinguish objects (no duplication), maximum 10
   Value	Value for the selected key
   [Trash can] icon	Delete the corresponding tag when clicked

Edit name

You can edit the name of an object.

1. In the Objects tab, select the [More] icon > Edit name of the object you want to rename.
2. Edit the object name and click the Edit button.

Copy object URL

You can look up the unique URL for each file that can access each file in the public bucket.
The URL structure consists of https://{region-name}.kakaocloud.com/v1/{project-ID}/{bucket-name}/{object-key}.

1. In the Objects tab, select the [More] icon > Copy object URL of the object whose URL you want to copy.
2. The object URL information is saved to the clipboard.

Copy

You can copy objects to another location (bucket).

1. In the Objects tab, select the [More] icon > Copy of the object you want to copy.
2. Select the bucket and path to copy the object and click the copy button.

When copying files, whether it is possible depends on the bucket's encryption settings, so please refer to the table below.

Availability of copying depending on encryption settings

Set up encryption for existing locations	Encryption settings for copy location	Copy availability
encryption (use_encryption: true)	encryption (use_encryption: true)	possible
encryption (use_encryption: true)	encryption (use_encryption: false)	possible
encryption (use_encryption: false)	encryption (use_encryption: true)	possible
encryption (use_encryption: false)	encryption (use_encryption: false)	possible

Move

You can move files to another location (bucket).

1. In the Objects tab, select the [More] icon > Move of the object you want to move.
2. Select the bucket and path to move the object to and click the Move button.

When moving files, whether it is possible depends on the bucket's encryption settings, so please refer to the table below.

Availability of movement depending on encryption settings

Set up encryption for existing locations	Encryption settings for copy location	Copy availability
encryption (use_encryption: true)	encryption (use_encryption: true)	possible
encryption (use_encryption: true)	encryption (use_encryption: false)	possible
encryption (use_encryption: false)	encryption (use_encryption: true)	possible
encryption (use_encryption: false)	encryption (use_encryption: false)	possible

Download

You can download any object you want.

1. In the Objects tab, select the [More] icon > Download of the object you want to download.
2. The object is downloaded through the browser.

Delete object

You can delete objects that are no longer in use.

1. In the Objects tab, select the [More] icon > Delete of the object you want to delete.
2. On the delete screen, check the list of objects to be deleted and click the delete button.

caution

Once deleted, objects cannot be recovered, so please be careful when deleting them.

Check details of object

You can check detailed information about the object.

1. Go to Beyond Storage Service > Object Storage in the KakaoCloud Console.

2. Select a bucket in the Bucket menu.

3. In the Objects tab, select link of the object name to check information to check object details.

4. Check detailed information on the Object details page.

   

   Category	Name	Description
   Object overview	Name	Object file name
   	Type	Object type
   	Last modified date	Last modified date of object
   	Size	Object size
   	URL	Object URL information
   Object management overview	Expiration rule	Life cycle policy name
   	Expiration date	Object expiration date according to life cycle policy - Objects are deleted sequentially after the object expiration time. Objects may remain even after the expiration time has expired, but they will be deleted over time.
   Metadata		Object metadata information
   Object tag		Object tag information