This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

How-to guides

Users can create the service by entering the required Object Storage information and selecting detailed options through the Samsung Cloud Platform Console.

Create authentication key

To create and use the Object Storage service in the Samsung Cloud Platform Console, you must first generate an authentication key.

You can generate an authentication key at My menu > My Info. > Authentication Key Management > Generate Authentication Key. For more details, refer to IAM > Create Authentication Key.

Reference
  • Authentication keys (Access Key, Secret Key) are used when authenticating Amazon S3 utilities.
  • The authentication key is used not only for Object Storage but also for authentication with OpenAPI and the CLI.
  • You can generate up to two authentication keys.
Caution
  • If the authentication key expires, access to the Object Storage service will be restricted. To ensure smooth service usage, check the authentication key’s expiration period in advance.
  • If you disable the authentication key, access permissions to the Object Storage service will be restricted.

Create Object Storage

You can create and use the Object Storage service from the Samsung Cloud Platform Console.

To create an Object Storage, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  2. Click the Create Object Storage button on the Service Home page. You will be taken to the Create Object Storage page.
  3. On the Object Storage Creation page, enter the information required to create the service.
    Category
    Required
    		Detailed description
    Bucket nameRequiredBucket name created by the user
    • must start with a lowercase letter or digit and be composed of lowercase letters, digits, hyphen-, and period. using 3 to 63 characters
    • period.cannot appear consecutively two or more times.
    • period.and hyphen-cannot be adjacent.
    • period.or hyphen-cannot be at the end.
    • IP address format is not allowed
    • admin name is not allowed
    Table. Object Storage required information input fields
Caution
When creating with the bucket name that is currently used as an Archiving target in the Archive Storage service, the configured Archiving policy will be applied, so be careful.
  1. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Create button.
    • Once creation is complete, check the created resource on the Object Storage list page.

Check detailed information of Object Storage

Object Storage service allows you to view and edit the full resource list and detailed information.
The Object Storage Details page consists of Details, Folder List, Tags tabs.

To view detailed information about the Object Storage service, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  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 whose detailed information you want to view. You will be taken to the Object Storage Details page.
    • Object Storage Details page displays status information and additional feature information, and consists of Details, Folder List, Replication, Tags tabs.
      CategoryDetailed description
      Bucket statusBucket status
      • Active: Available
      Service terminationCancel Service button
      Table. Status information and additional features
Reference
Object Storage resources do not support operation history.
If needed, please check via the Logging&Audit service. For more details, see Logging & Auddit > How-to Guides.

Detailed Information

Object Storage List page lets you view detailed information of the selected resource and edit it if necessary.

CategoryDetailed description
ServiceService name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
  • In the Object Storage service, it refers to a bucket SRN
Resource nameResource Name
  • In the Object Storage service, it refers to the bucket name
Resource IDUnique resource ID in the service
Bucket nameUser-created bucket name
CategoryField that distinguishes between original and replica
  • Currently only the original exists, and a replica will be added when the DR feature is introduced later
UsageTotal data usage of the bucket
EncryptionEncryption usage information
  • When encryption is enabled, the SSE‑S3 encryption key method and the AES256 encryption algorithm are applied
  • Encryption settings can be configured on the Object Storage Details page after creating an Object Storage
Version controlVersion Management Usage Information
  • If you need to configure version management, click the Edit button
URLObject Storage provides Public and Private URLs for access
  • Public: Provided for access from external networks
  • Private: Provides an address accessible from resources created within the same Account in the Samsung Cloud Platform Console
Access ControlWhen access control is enabled, you can restrict access to the bucket so that only authorized resources can access it
  • After switching to use access control, click the Edit button for each permission to add the resources you want to allow
    • Public IP Allowance: Add using a single IP/CIDR format
    • Service Resource Allowance: Select service resources created in the same account/region
    • Cloud Functions Service: Set whether the service is enabled
  • For more details on access control, see 접근 제어 for reference
Table. Object Storage detailed information tab items

Folder list

You can view the list of folders and files stored in the bucket via the Folder List tab.

CategoryDetailed description
NameFile name or folder name
sizeFile size
Modification date and timeThe date and time the file was last modified
Additional features > MoreFile and folder management buttons
  • File Information: View additional information about the file
    • File Copy: Copy the file
    • Edit Permissions: Set the file’s Public Access permission
    • Version List: If versioning is enabled, view the version list
    • Download: Download the selected file
    • Create Presigned URL: Allows file download using a Presigned URL for the configured duration
      • Enter the required usage time (1–720 minutes), then click the Create button to generate
    • Delete: Delete the selected file or folder
      • For folders, only deletion is possible
New folderAdd new folder
File uploadUpload a new file or a file you are working on
DeleteDelete file or folder
  • When multiple files are selected, the Delete button is enabled
  • Deletion possible when selecting a single/multiple folder(s)
  • Deletion possible when selecting a single/multiple file(s)
  • Deletion possible when selecting multiple files and folders
DownloadFile download
  • Downloadable only when a single file is selected
  • Button disabled when a folder is selected
  • Button disabled when multiple files are selected
  • Button disabled when multiple files and folders are selected
Table. Folder list tab items
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
  • If the delete marker is the latest version, it cannot be seen in the folder list.
  • The delete marker version cannot be viewed in the version list.

Replication

Object Storage List page lets you view and manage the replication information of the selected resource.

CategoryDetailed description
Policy NameEnter the replication policy name
  • using English letters, numbers, and special characters (-,.) within 255 characters
Replication targetReplication target bucket name
Clone locationReplication location (region)
target fileList of files to be replicated
statusReplication policy status
  • Active: Enabled
  • Inactive: Disabled
AddAdd a new replication policy
MorePolicy management available
  • Disable: Disable the policy (displayed as enabled when disabled)
  • Edit: Modify the replication target, target files, and options of the replication policy
Service Watch replication metricsEnable replication metrics to view monitoring data for Object Storage replication in Service Watch
  • Grant permission for Object Storage’s BucketReplicationMetric
  • Additional charges apply when using replication metrics
  • Click the Edit button to change whether replication metrics are enabled
Table. Object Storage replication information tab items

tag

Object Storage List page lets you view, add, modify, or delete the tag information of the selected resource.

CategoryDetailed description
Tag listTag list
  • You can view the Key and Value information of tags
  • Up to 50 tags can be added per resource
  • When entering a tag, you can search and select from the list of previously created Keys and Values
Table. Object Storage Tag Tab Items

Job History

Reference
Object Storage resources do not support operation history.
If needed, please check via the Logging&Audit service. For more details, see Logging&Auddit > How-to Guides.

Object Storage Encryption Configuration

You can configure the bucket to encrypt the data stored in it. After enabling bucket encryption, the encryption settings are applied to uploaded data. When encryption is used, the SSE‑S3 encryption key method and the AES256 encryption algorithm are applied.

Reference
Object Storage’s bucket encryption can provide two options (SSE‑S3/SSE‑KMS). SSE‑S3 is server‑side encryption (SSE‑S3) using Amazon S3 managed keys. SSE‑KMS is server‑side encryption (SSE‑KMS) using Key Management Service (KMS) keys.
In this service, we have launched server‑side encryption (SSE‑S3) using Amazon S3 managed keys as the default method, and server‑side encryption (SSE‑KMS) using Key Management Service (KMS) keys will be offered later according to the service roadmap.

guide

If there is data that was stored before the bucket encryption was configured, the encryption setting will not be applied.

  • If you re‑upload the file, the encryption will be applied.
  • To enable encryption for existing data, you need to re‑upload it.

Object Storage Follow the steps below to enable bucket encryption.

  1. Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page of Object Storage.
  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) to use for encryption. You will be taken to the Object Storage details page.
  4. On the Object Storage Details page, verify whether encryption is not used.
  5. If Encryption is unused, click the Edit button.Encryption Edit Popup opens.
  6. After checking Use for encryption, click the Confirm button.

Terminate Object Storage

You can cancel unused Object Storage to reduce operating costs. However, if you cancel the service, the running service may be stopped immediately, so you should thoroughly consider the impact of service interruption before proceeding with the cancellation.

Caution
  • Service termination is possible for buckets that have no stored data.
  • If a file is being uploaded, the upload will be canceled.
  • Please be careful, as data cannot be recovered after deletion.

To cancel Object Storage, follow the steps below.

  1. Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page of Object Storage.
  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, select the resource (bucket) to cancel, and click the Cancel Service button.
  4. Enter bucket name to confirm cancellation.
  5. If you have entered the Bucket name correctly, the Confirm button will be activated. Click the Confirm button.
  6. When termination is complete, verify on the Object Storage list page that the resource has been terminated.

1 - Access Control

If you set bucket access control to enabled, only resources that are permitted can access the bucket. You can enter a public IP or configure settings to allow access to resources created in the Samsung Cloud Platform Console.

Setting up Access Control

You can set the bucket’s access control to enabled.

Object Storage Follow the steps below to configure access control settings.

  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) to set access control. You will be taken to the Object Storage Details page.
  4. Verify on the Object Storage Details page whether access control is unused.
  5. Access control is disabled, click the Edit button. Access control edit popup opens.
  6. After checking Use for access control, click the Confirm button. In the Object Storage Details page, access control will be set to Use.
guide
If you change the access control to Enabled, you can configure the access control for Public UP, service resources, and Cloud Functions services.
  1. Register service resources to grant access using a Public IP, or configure whether to enable access control for the Cloud Functions service.
CategoryDetailed description
Allow public IPAdd registered Public IP or CIDR
  • Example: 192.168.x.x, 192.168.x.x/24
Allow service resourcesSelect service resources created in the same Account/Region
  • Service: Service name
    • Examples: Virutal Server, GPU Server, Bare Metal Server, Multi-node GPU Cluster, VPC Endpoint, PostgreSQL, MariaDB, MySQL, EPAS, Microsoft SQL Server
  • Resource name: Name of the service resource
Allow Cloud Functions serviceSetting whether to allow Object Storage access to modify Java Runtime code in the Cloud Functions service
  • When set to Allow, the Cloud Functions service can retrieve Java Runtime executable files stored in Object Storage.
Table. Access Control Items
Reference
If you modify the access permission, it may take up to 30 seconds for the changes to be applied.
Reference

South Korea (kr-south) region constraints

  • The South Korea (kr-south) region does not provide Cloud Funtions service, so the Allow Cloud Functions Service feature cannot be used.

Allow public IP access

If the bucket’s access control is set to enabled, you can add a public IP allowance.

To add Public IP access permission in Object Storage, 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 set access control. You will be taken to the Object Storage Details page.
  4. On the Object Storage Details page, verify that access control is enabled.
    • If Access Control is Disabled, click the Edit button, then change Access Control to Enabled in the Access Control popup.
    • When access control is enabled, only the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service lists are displayed.
  5. Click the Edit button in Allow Public IP. The Edit Allow Public IP popup window opens.
  6. Enter the Public IP to allow access, and click the Add button.
    columnRequiredDetailed description
    Allow public IPRequiredEnter a single IP or CIDR format (up to 150 entries)
    • 192.168.x.x (IP format)
    • 192.168.x.x/24 (CIDR format)
    Table. Public IP Allowance Edit Popup Input Fields
  7. Verify the items added to the list and click the Confirm button.
  8. Check the added Public IP in the Object Storage Details page’s Access Control > Allow Public IP list.
Reference
  • If you modify the public IP allowance, it may take up to 30 seconds for the changes to be applied.
  • A maximum of 150 public IPs are allowed.

Allow access to service resources

If access control is set to enabled on the bucket, you can add service resources in the service resource allowance.

To permit access to service resources in Object Storage, 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 set access control. You will be taken to the Object Storage Details page.
  4. Verify that Access Control is enabled on the Object Storage Details page.
    • If Access Control is Disabled, click the Edit button, then change Access Control to Enabled in the Access Control popup.
    • When access control is enabled, only the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service lists are displayed.
  5. Click the Edit button in Service Resource Allowance. The Service Resource Selection popup opens.
guide

  • The permissible criteria for each service are as follows.

    • Virtual Server/GPU Server/Bare Metal Server/Multi-node GPU Cluster: Allowed per server
    • VPC Endpoint: Allow per VPC Endpoint
    • PostgreSQL, MariaDB, MySQL, EPAS, Microsoft SQL Server: Allowed per cluster

  • The following steps are required to access Object Storage from the server.

    1. Check the Object Storage IP on the server using the nslookup command
    2. Register a rule through the Security Group or Firewall service and apply it to the server.
      • Target address: Object Storage IP confirmed in ①
      • Direction : Outbound
      • Service: TCP 80, 443 (80 when using http / 443 when using https)
Caution

If each service’s status is as follows, granting and revoking access to service resources is possible. If the status is not as listed, previously granted service resources may also be affected.

  • Virtual Server/GPU Server: Build, Building, Networking, Scheduling, Block_Device_Mapping, Spawning, Deleting, Error and other states
  • Bare Metal Server/Multi-node GPU Cluster: Running, Starting, Stopping, Stopped
  • VPC Endpoint: Active
  • PostgreSQL/MariaDB/MySQL/EPAS/Microsoft SQL Server: Running
  1. Select the server to allow access, and click the Confirm button.
  2. Check the added server in the Object Storage Details page’s Access Control > Allow Service Resources list.
Reference
  • If you modify the service resource allowance, it may take up to 30 seconds for the changes to be applied.
  • Service resources are allowed up to a maximum of 150.

Allow access to Cloud Functions service

If access control on the bucket is set to enabled, you can allow the Cloud Functions service to access Object Storage.

To allow access to the Cloud Functions service from Object Storage, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. You will be taken 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) for which you want to set access control. You will be taken to the Object Storage Details page.
  4. On the Object Storage Details page, verify that access control is enabled.
    • Access Control is Disabled, click the Edit button, then in the Access Control popup, change Access Control to Enabled.
    • When access control is enabled, only the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service lists are displayed.
  5. In the Enable Cloud Functions service, click the Edit button. The Edit Cloud Functions service popup opens.
  6. After checking Allow, click the Confirm button.
Reference
  • Once the access permission settings for the Cloud Functions service are completed, the Cloud Fuctions service can retrieve the Java Runtime executable stored in Object Storage.
  • In the Cloud Functions service, see Java Runtime 코드 변경하기 for how to load the Java Runtime executable.
Reference

South Korea (kr-south) region constraints

  • The South Korea (kr-south) region does not provide the Cloud Functions service, so the Allow Cloud Functions Service feature cannot be used.

2 - File and Folder Management

If you need to manage tasks such as storing files in the created Object Storage or downloading stored files, you can perform the operations on the Object Storage Details and Folder List pages.

Create new folder

A new folder may need to be created to store new data in the bucket.

To create a new folder in Object Storage, 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) where you want to create a new folder. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. Navigate to the Folder List page.
  5. Click the New Folder button. The New Folder popup window opens.
  6. Enter the folder name to use, and click the Confirm button. A popup indicating that a new folder has been created will appear.
Caution
  • Folder names must not contain prohibited special characters. For more details, see Folder Name Creation Rules.
  • The total path length, including the folder name, file name, and delimiter (/), must be limited to within 1,024 bytes (based on UTF-8 encoding).
  1. After clicking the Confirm button, check the created folder in the Folder List.

Upload 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 constraints
    • 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 upload a new file or a file you are working on to the bucket. Object Storage Follow the steps below to upload files.

  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) to upload files. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. Navigate to the Folder List page.
  5. Click the File Upload button. The File Upload popup opens.
  6. After clicking the Attach File button, select the file to upload or drag the file to attach into the popup window.
Caution
  • You can upload up to three attachment files, each not exceeding 3 GB.
  • The attached file name must not contain prohibited special characters. For more information, refer to File Name Creation Rules.
  • The total path length, including the folder name, file name, and separator (/), must be within 1,024 Bytes (based on UTF-8 encoding).
  • If a duplicate file exists, you cannot upload.
  1. If you have selected all files, click the Upload button.
  2. If the upload was successful, check the file in the folder list.

Download 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 files stored in the bucket. Object Storage Follow these steps to download the file.

  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) you want to download. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. Navigate to the Folder List page.
  5. Click the More > Download button located at the far right of the file. The file download will begin.
  6. Verify that the file download has completed in the browser.

View file information

You can retrieve information about files stored in the bucket. Object Storage Follow the steps below to retrieve file information.

  1. All Services > Storage > Object Storage Click the menu. Navigate to the Service Home page.
  2. Click the Object Storage menu on the Service Home page. You will be taken to the Object Storage List page.
  3. Object Storage List page, click the resource (bucket) that contains the file you want to view information for. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. You will be taken to the Folder List page.
  5. Click the More > File Info button located at the far right of the file you want to view information for. The File Info popup window will open.
  6. File Information Check detailed file information in the popup window.
    CategoryDetailed description
    filenameFile name
    Content typeObject type
    Total sizeFile size
    Modification date and timeThe most recent modification date and time of the file
    PermissionWhether to allow Public Access
    URLProvide Public and Private addresses to enable access to file paths via URL
    • Public: Provided to allow access from external internet networks
    • Private: Provides an address accessible from resources created in the same account and region of the Samsung Cloud Platform Console
    Table. File information items

Copy file

You can copy a file stored in a bucket to the same location. To copy a file, follow these steps.

  1. Click the Storage > Object Storage menu. Navigate to the Object Storage List page.
  2. Object Storage List page, click the resource (bucket) to copy the file. You will be taken to the Object Storage Details page.
  3. Click the Folder List tab. You will be taken to the Folder List page.
  4. Click the More > Copy File button at the far right of the file to be copied. The Copy File popup window will open.
  5. Enter the filename, then click the OK button. A popup indicating file copying will appear.
Caution
  • Only files whose full path—including bucket name, folder name, file name, and delimiter (/)—is 1,024 Bytes (based on URL encoding) or less can be copied.
  • In the Samsung Cloud Platform Console, you can only copy files when the file size is 5 GB or less. If the file size exceeds 5 GB, you can copy it using the S3 API.
  • You can copy within the same bucket and folder.
  • If the bucket does not use versioning, a file with the same name in the folder will be overwritten.
  1. After clicking the Confirm button, check the copied file in the Folder List.

Delete files and folders

You can delete files and folders stored in the bucket. Object Storage Follow the steps below to delete files and folders.

Caution
  • When a folder is deleted, all subfolders and files inside it are also deleted.
  • When a file is deleted, all versions are deleted at once.
  • Files with object lock (WORM) enabled cannot be deleted.
  1. Click the All Services > Storage > Object Storage menu. You will be taken 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 or folder you want to delete. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. Navigate to the Folder List page.
  5. Click the More > Delete button located at the far right of the file or folder you want to delete. The Delete popup window will open.
    • After selecting multiple files or folders using the checkboxes on the left, you can delete them all at once by clicking the Delete button at the top.
  6. Click the Confirm button in the delete popup to complete deletion.
  7. Check that files or folders have been deleted from the Folder List.
Reference
Deleting multiple files and folders simultaneously can take a long time.

3 - 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.

4 - Permission Management

Each file is provided with Private permission by default, and each file can be changed to Public permission through permission settings. Private permission allows file access and download only to users who know the Access Key and Secret Key, whereas Public permission allows anyone worldwide to access and download the file via its Public URL, so caution is required.

Check permission management

You can check the file’s permission settings.

Object Storage Follow the steps below to verify file permissions.

  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 permissions you want to check. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. Navigate to the Folder List page.
  5. Click the More > File Info button located at the far right of the file you want to view file information for. The File Info popup window will open.
  6. Check the Permissions in the File Information popup window.
    CategoryDetailed description
    PermissionPublic Access allowed or Public Access not allowed
    Table. Permission information description

Allow Public Access

You can set the file’s Public Access permission to Allow. To set the file permissions of Object Storage to allow Public Access, 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 files to allow Public Access. You will be taken to the Object Storage Details page.
  4. Click the Folder List tab. Navigate to the Folder List page.
  5. Click the More > File Info button located at the far right of the file you want to view information for. The File Info popup window will open.
  6. Check that Permission is in Public Access not allowed state, then click the Confirm button.
  7. Click the More > Permission Management button located at the right end of the file. The Edit Permission Management popup window opens.
  8. Edit Permission Management popup window, check Permission Management’s Allow Public Access, and click the Confirm button. You will be taken to the Folder List page.
  9. Click the More > File Info button at the far right of the file. The File Info popup opens.
  10. Check that Permission is Public Access allowed.
guide
When Public Access is enabled, accessing the file’s Public URL makes the file publicly available and downloadable to anyone worldwide.
Please enable file sharing only when it is absolutely necessary.

5 - Replication Policy Management

Replication can be performed on a bucket in a different location or the same location.
You can configure multiple replication policies, and if the source bucket becomes unavailable due to a failure or disaster, you can provide the service through the replica bucket.

Information
  • The replication feature operates in a 1:N structure, allowing replication within a region or between regions. When performing cross‑region replication, data transfer fees are added.
  • The replication feature applies only to files uploaded after the replication policy is set.
  • Deleting the versioned file in the source does not delete the files in the replica bucket.
    • Example: When configured from Bucket A → Bucket B, even if the version files in Bucket A are deleted, they remain in Bucket B.
  • Bidirectional replication can be configured.
    • Example: When configured as Bucket A ↔ Bucket B, files uploaded to Bucket A are replicated to Bucket B, and files uploaded to Bucket B are replicated to Bucket A.
  • The duplicated file is not duplicated.
    • Example: When configured as Bucket A → Bucket B → Bucket C, files replicated from Bucket A → Bucket B are not replicated from Bucket B → Bucket C.
Reference
The kr-south region does not provide inter-region Object Storage replication.

Add replication policy

Information
  • You can configure replication on the created bucket.
  • To add a replication policy, you must set the version control feature to enabled.
  • Refer to Configure Version Management for how to configure the version management feature.

To add a replication policy, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  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 to which you want to add a replication policy. Then navigate to the Object Storage Details page.
  4. Click the Clone tab.
  5. Click the Add button. The Add Replication Policy popup opens.
  6. After entering the policy information, click the Confirm button. A popup notifying the creation of a replication policy will appear.
CategoryRequired or notDetailed description
Policy NameRequiredEnter the name of the replication policy
  • including English letters, numbers, and special characters (-._) within 255 characters
Clone locationRequiredSelect replication location (region)
  • Other locations can be selected
Replication bucket nameRequiredSelect the name of the replica bucket
  • If set to be the same as the source bucket name, adding a replication policy is not allowed
target fileRequiredSelect files to duplicate
  • All: Duplicate all files
  • Prefix: Duplicate files that start with the value entered as a prefix
    • Enter within 1,024 bytes based on UTF-8 encoding (same as file length restriction)
    • Special characters (%<>#\`^)
Delete marker duplicationSelectWhether to use delete marker replication
Table. Add replication policy popup items
  1. Click the Confirm button. The replication policy will be added.
Caution

If there is an invalid policy, you cannot add a replication policy.

  • Example: If a replication bucket has been deleted but its policy remains, you cannot add a replication policy.

Modify Replication Policy

You can modify the replication location, replication bucket name, and target file of the replication policy.

guide
  • To modify the replication policy, you must set the versioning feature to enabled.
  • Refer to Configure Version Management for instructions on configuring the versioning feature.

To modify the replication policy, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  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 to edit the replication policy. You will be taken to the Object Storage Details page.
  4. Click the Clone tab.
  5. In the replication policy list, click the More > Edit button of the policy you want to modify. The Edit Replication Policy popup window will open.
  6. After modifying the replication policy information, click the Confirm button. A popup notifying the replication policy modification will appear.
CategoryRequired?Detailed description
Clone locationRequiredSelect the replication location (region)
  • Other locations can be selected
Replication bucket nameRequiredEnter the name of the replicated bucket
  • If set to the same as the source bucket name, the replication policy cannot be modified
  • If you set a bucket that is already in use as the replication bucket, the replication policy cannot be modified
target fileRequiredSelect files to replicate
  • All: Replicate all files
  • Prefix: Replicate files that start with the entered prefix
    • Enter within 1,024 bytes based on UTF-8 encoding (same as file length limit)
    • Special characters (%<>#\`^\
Delete marker duplicationSelectionWhether to use delete marker replication
Table. Replication Policy Edit Popup Items
  1. Click the Confirm button. The replication policy update is complete.
Caution

If there is an invalid policy, you cannot add a replication policy.

  • Example: If a replication bucket has been deleted but its policy remains, you cannot add a replication policy.

Changing Replication Policy Status

You can enable or disable the replication policy to change whether it is executed.

To change the replication policy status, follow the steps below.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  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 whose replication policy status you want to change. You will be taken to the Object Storage Details page.
  4. Click the Clone tab.
  5. From the replication policy list, click the More > Enable or More > Disable button for the policy whose status you want to change. A popup will appear notifying you of the replication policy status change.
    • Enabled: Performs replication according to the replication policy.
    • Disabled: Stops replication.
  6. Click the Confirm button. The status of the replication policy will change.

Delete replication policy

You can delete unused replication policies.

To modify the replication policy, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  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 to delete the replication policy. Go to the Object Storage Details page.
  4. Click the Clone tab.
  5. In the replication policy list, click the More > Delete button for the policy you want to modify. A popup notifying you of the replication policy deletion will appear.
  6. Click the Confirm button. The replication policy will be deleted.
Caution
  • If you change the versioning setting of the source and replica buckets, replication will not function properly.
    • If versioning on the source bucket is set to disabled, replication is not performed. Setting it to enabled will replicate files uploaded after the setting.
    • If you set versioning of the replica bucket to disabled, replication will be performed but versioning is not possible. If you set it back to enabled, versioning will apply from the point of configuration onward.
  • If you delete the source bucket, the configured replication policy will also be deleted.
  • If you delete the replica bucket, the replication policy configured on the source bucket is retained.
    • If you recreate a replication bucket with the same bucket name as a deleted replication bucket, replication will be performed to that bucket.

Activating ServiceWatch Replication Metrics

By default, Object Storage is integrated with ServiceWatch and basic monitoring. To link Object Storage replication metrics to ServiceWatch, you must enable ServiceWatch replication metric. For more information about ServiceWatch, see ServiceWatch Overview.

Caution
  • Basic monitoring is provided at no cost, but enabling replication metrics as a detailed monitoring item incurs additional fees.
  • The ServiceWatch replication metric, when configured once per bucket, applies to all replication policies of that bucket.

To enable the ServiceWatch replication metric for Object Storage, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page of Object Storage.
  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 to enable ServiceWatch replication metrics. Then go to the Object Storage Details page.
  4. Click the Replication tab on the Object Storage Details page. Proceed to the Replication tab.
  5. Click the Edit button for the ServiceWatch replication metric. You will be taken to the Edit ServiceWatch replication metric popup.
  6. ServiceWatch Replication Metric Edit In the popup window, after selecting Enable, review the instructions and click the Confirm button.
  7. In the Replication tab, view the ServiceWatch replication metric items.

Disabling ServiceWatch Replication Metrics

Caution
Disabling the replication metric is required for cost efficiency. Keep the replication metric enabled only when absolutely necessary, and disable the replication metric for the rest.

To disable the ServiceWatch replication metric for Object Storage, follow these steps.

  1. Click the All Services > Storage > Object Storage menu. Navigate to the Service Home page of Object Storage.
  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 to disable ServiceWatch detailed monitoring. Navigate to the Object Storage Details page.
  4. On the Object Storage Details page, click the Replication tab. Navigate to the Replication tab.
  5. Click the Edit button for the ServiceWatch replication metric. You will be taken to the Edit ServiceWatch replication metric popup.
  6. ServiceWatch Replication Metric Edit In the popup window, after deselecting Enable, review the guidance text and click the Confirm button.
  7. In the Replication tab, check the ServiceWatch replication metric items.