The page has been translated by Gen AI.

Version Management

By enabling versioning on a bucket, you can track the history of file modifications when uploading files with the same name. You can also view the file’s version list and download previous versions of the file from the list.

Information
With the version control feature, if you accidentally upload a file and overwrite an existing one, you can locate the previous version using the version list.

Setting up version control

You can enable versioning on the bucket.

Caution
When using S3 FileSystem Backend solutions (e.g., s3fs, objectivefs, etc.), it is recommended not to enable versioning. Enabling versioning may cause performance degradation.

Object Storage To set up versioning, follow the steps below.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
  2. On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
  3. On the Object Storage List page, click the resource (bucket) for which you want to configure versioning. You will be taken to the Object Storage Details page.
  4. On the Object Storage Details page, verify whether Versioning is unused.
  5. If Version control is unused, click the Edit button. The Edit version control popup window opens.
  6. After checking version management as Enabled, click the Confirm button. On the Object Storage Details page, Version Management will be changed to Enabled.
reference
  • When you configure version control for the first time, it may take some time for changes to be applied.
  • The time required may vary depending on the size of the bucket. Work performed before the configuration is completed may not have the version applied.

Check version list

From the moment version control is configured, you can view and manage versions of file uploads and modifications.

Information
  • Version control for file uploads and edits is available from the moment version control is configured.
  • All files have a version ID. However, before version control is configured, the version ID is null(-), and files uploaded after version control is set up are assigned a generated version ID.
    • For example, if you upload a file with the same name to the same location, the file name remains the same, but a new version file with a different version ID appears in the version list.

Object Storage To check the version list of a file, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
  2. On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
  3. Object Storage List page, click the resource (bucket) that contains the file whose version list you want to view. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. The folder and file list will be displayed.
  5. In the folder and file list, click the More > Version List button located at the far right of the file whose version list you want to view. The Version List popup will open.
    CategoryDetailed description
    filenameFile name
    Modification dateFile modification date and time
    Version IDVersion ID assigned to each individual file
    • Before version control is enabled, the version ID of saved files is displayed as null(-)
    • Files saved after version control is enabled are assigned a unique version ID
    • If a file with the same name is uploaded to the same location, a version ID is generated, a versioned file is added, and it can be viewed in the version list
    EtagObject that identifies files, specific version
    SizeVersion file size
    MoreProvides version file download and delete functions as additional features
    • File Download: Download the file of the selected version
      • To restore a file to a previous version, download the previous version and re‑upload it
      • Delete: Delete the file of the selected version
        • If all version files are deleted, the original file will also be deleted
        • To retain the original file, at least one version must be kept
    DeleteDelete file
    • Enable the button when selecting the checkbox of the version file to delete from the list
    Table. Version list popup items

Download version file

Reference
  • South Korea Region 3 (kr-south3) constraints
    • File upload and download capabilities are limited through the Samsung Cloud Platform Console.
    • Use of the S3 API/CLI via a public URL is restricted.
    • However, private URL access is possible through resources (such as Virtual Server) created in the Samsung Cloud Platform Console.
  • South Korea South 1 (kr-south1), South Korea South 2 (kr-south2) region restrictions
    • To access the public URL, you must allow a separate firewall configuration.
    • You can view the public URL address on the Object Storage details page. Refer to Check Object Storage Details.

You can download the version file. To download the version file of a Object Storage file, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
  2. On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
  3. On the Object Storage List page, click the resource (bucket) that contains the version file to download. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. The folder and file list will be displayed.
  5. In the folder and file list, click the More > Version List button located at the far right of the file for which you want to download the version file. The Version List popup window will open.
  6. Click the More > File Download button located at the far right of the version file. File download will start.
  7. Verify that the file download has completed in the browser.
Reference
When you download a version file from the version list, the filename includes the version ID.

Delete version file

You can delete a file’s version list.

Caution
  • If you delete all version files, the original file will also be deleted. To avoid deleting the original file, you must keep at least one version.
  • Version files with object lock (WORM) enabled cannot be deleted.

Object Storage To delete a file’s version list, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page.
  2. On the Service Home page, click the Object Storage menu. You will be taken to the Object Storage List page.
  3. Object Storage List: Click the resource (bucket) that contains the versioned file you want to delete. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. The folder and file list will be displayed.
  5. In the folder and file list, click the More > Version List button located at the far right of the file whose version list you want to delete. The Version List popup window will open.
  6. Click the More > Delete button at the far right of the version file you want to download. Deletion will be completed.
File and Folder Management
Permission Management