This is the multi-page printable view of this section. Click here to print.
File Storage
- 1: Overview
- 1.1: Monitoring Metrics
- 1.2: ServiceWatch Metrics
- 2: How-to guides
- 2.1: Connect to Server
- 2.2: Use Snapshot
- 2.3: File-level Recovery
- 2.4: Use Disk Backup
- 2.5: Use Replication
- 3: API Reference
- 4: CLI Reference
- 5: Release Note
1 - Overview
Service Overview
File Storage enables servers connected via a network to easily store and share data, making it a storage solution suitable for application environments that use multiple servers.
You can choose the disk type according to the required performance level, and it will automatically expand or shrink based on the user’s data volume without any capacity limits.
Features
- Free volume usage: The volume capacity automatically expands or contracts based on data creation and deletion without any user configuration. There is no cost for creating the volume; only usage fees for the stored data capacity are incurred.
- Various Disk Types Available: Users can select a disk type based on their usage purpose. They can use HDDs that store large amounts of data cost‑effectively, SSDs that provide reduced response times and high IOPS performance, and high‑performance SSDs.
- Snapshot Backup: The image snapshot feature enables recovery of modified or deleted data, and when performing disk backup, snapshots can be stored in a location different from the original. Users select a snapshot created at the desired point in time from the list to perform the recovery.
- Replication: Creates an identical replica volume at a different location, and users can set the data replication interval. If the original volume becomes unavailable due to failures or disasters, service can be provided through the replica volume.
Configuration diagram
Provided features
File Storage provides the following features.
- Volume Name: Users can set a name for each volume.
- Disk type: You can select a disk type based on the user’s performance requirements.
- HDD: Standard volume
- SSD: high‑performance general volume
- High‑Performance SSD: Performance‑optimized volume that can be attached to a Multi-node GPU Cluster
- Protocol: You can select the protocol based on the user’s OS image.
- NFS: Primarily used on Linux operating systems
- CIFS: Primarily used on Windows operating systems
- Flexible Volume Usage: Provides flexible volume sizing based on the amount of stored data without requiring user capacity settings.
- Connected Resources: can be connected and used from Virtual Server, Bare Metal Server, and Multi-node GPU Cluster.
- Encryption: Regardless of disk type, all volumes are encrypted with the XTS-AES-256 algorithm.
- Snapshot: The image snapshot feature allows immediate or scheduled snapshot creation.
- Retention Count: The number of snapshots retained that are automatically created by the schedule
- Schedule: Snapshot auto-creation interval
- Recovery: restore the original volume to the latest snapshot, or select a snapshot at a specific point in time to create a recovery volume
- Replication: It replicates the volume to another location, and the user can set the replication schedule.
- Disk Backup: You can store snapshots on a backup-dedicated HDD storage and select the backup location.
- VPC Endpoint connection: File Storage can be used via a Private Network connection from an external network.
- Monitoring: usage, IOPS, Throughput, and other monitoring data can be viewed through the Cloud Monitoring service.
- ServiceWatch Service Integration: You can monitor data using the ServiceWatch service.
Component
You can create a volume by selecting the disk type and protocol according to the user’s service environment and performance requirements.
When using the snapshot feature, you can restore data to the desired point in time.
Volume
Volume(Volume) is the basic creation unit of the File Storage service and is used as data storage space. Users select a name, disk type, and protocol (CIFS/NFS) to create a volume, then connect it to one or more Server for use.
The volume name generation rules are as follows.
- It must start with a lowercase English letter and can be set to 3~21 characters using lowercase letters, numbers, and special characters (
_).
Snapshot
Snapshot is an image backup taken at a specific point in time. Using the image snapshot feature, you can recover changed or deleted data or store snapshots in a location different from the original when performing disk backups. Users select the snapshot created at the desired point in time from the snapshot list to perform a recovery.
The following are considerations when using snapshots.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00). Snapshots can be created up to a maximum of 800, excluding those generated by schedule. (Automatic creation via schedule is limited to a maximum of 128)
- Select the snapshot recovery button to restore the File Storage volume to the latest snapshot.
- If you select a specific snapshot from the snapshot list, you can recover by creating a new volume based on that snapshot.
- Automatic creation is possible through snapshot schedule configuration.
- Since snapshot storage is included in File Storage usage and incurs charges, adjust the storage capacity by setting the snapshot retention period.
Preceding Service
This is a list of services that must be pre-configured before creating the service. Refer to the guide provided for each service for details and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Compute | Virtual Server | Virtual server optimized for cloud computing |
| Compute | Bare Metal Server | High-performance physical server used without virtualization |
1.1 - Monitoring Metrics
According to Samsung Cloud Platform’s policy, the Cloud Monitoring service is scheduled to be discontinued.
Accordingly, after the September 2026 release, resource monitoring of the Samsung Cloud Platform via Cloud Monitoring will no longer be possible.
With the new alternative service, you can continuously perform resource monitoring by using ServiceWatch, released in October 2025.
ServiceWatch provides more modern and powerful features, replacing Cloud Monitoring to deliver a smooth monitoring environment.
Detailed information about ServiceWatch: see the ServiceWatch Overview.
File Storage Monitoring Metrics
The table below shows the monitoring metrics for File Storage that can be viewed in Cloud Monitoring. For detailed usage of Cloud Monitoring, refer to the Cloud Monitoring guide.
| Performance Item Name | Explanation | unit |
|---|---|---|
| Instance Status | File Storage Volume Status | status |
| Volume Used | Usage | bytes |
| Volume Usage | Utilization | % |
| Volume Total | Total byte count | bytes |
| IOPS [Total] | iops(total) | iops |
| IOPS [Read] | iops(read) | iops |
| IOPS [Write] | iops(write) | iops |
| IOPS [Other] | iops(other) | iops |
| Latency Time [Total] | Latency (total) | usec |
| Latency Time [Read] | Read latency | usec |
| Latency Time [write] | Latency (write) | usec |
| Latency Time [Other] | Latency (Other) | usec |
| Throughput [Total] | Throughput (total) | bytes/s |
| Throughput [Read] | Throughput (read) | bytes/s |
| Throughput [Write] | Throughput (write) | bytes/s |
| Throughput [Other] | Throughput (Other) | bytes/s |
1.2 - ServiceWatch Metrics
File Storage sends metrics to ServiceWatch. The metrics provided by default monitoring are data collected at 1‑minute intervals.
Basic Metrics
The following are the basic metrics for the File Storage namespace.
The indicators whose names are displayed in bold below are the indicators selected as major metrics among the basic metrics provided by File Storage. Key metrics are used to configure service dashboards that are automatically generated for each service in ServiceWatch.
Each metric indicates, via the user guide, which statistical value is meaningful when viewing that metric, and among the meaningful statistics, the values shown in bold are the primary statistics. In the service dashboard, you can view key metrics using these primary statistical values.
| Indicator Name | Detailed description | unit | Meaningful statistics |
|---|---|---|---|
| status | File storage volume status | None | - |
| total_byte | Total bytes of file storage | Bytes |
|
| iops_read | IOPS (read) | - |
|
| iops_write | IOPS (write) | - |
|
| latency_read | Read latency | Microseconds |
|
| latency_write | Latency (write) | Microseconds |
|
| throughput_read | Throughput (read) | Bytes/Second |
|
| throughput_write | Throughput (write) | Bytes/Second |
|
2 - How-to guides
Users can create a service by entering the required information for File Storage and selecting detailed options through the Samsung Cloud Platform Console.
- Service fees are charged based on usage without capacity limits.
- Volumes are allocated 100 TB by default. If you need to use more than 100 TB, please inquire via Support Center’s Contact Us.
- Cost Management’s Payment Management, when you add or modify company information, the Mount name (IP information) of File Storage is automatically changed.
- Before modifying company information, be sure to check the service impact caused by changing the mount name (IP information).
Create File Storage
You can create and use the File Storage service from the Samsung Cloud Platform Console.
To create a File Storage, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the Create File Storage button. You will be taken to the Create File Storage page.
- File Storage Creation page, enter the information required to create the service, and select detailed options.
Category Whether requiredDetailed description Volume name Required Volume name - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
_)
- is generated as ‘user input value + {6-character UUID composed of lowercase English letters and numbers}’
- cannot be modified after the service is created
Disk types Required Select Disk Type - Disk Type
- HDD: Standard Volume
- SSD: High‑Performance Standard Volume
- High‑Performance SSD: Performance‑Optimized Volume that can be attached to a Multi‑node GPU Cluster
- Cannot be modified after service creation
- When creating a snapshot recovery volume, it is set identical to the original and cannot be modified
Protocol Required Protocols for sharing volumes over the network from a server - NFS: primarily used on Linux operating systems
- CIFS: primarily used on Windows operating systems
- When creating a service, the snapshot recovery volume is set identical to the original and cannot be modified
Protocol > Password Required Set the account password for volume access when using the CIFS protocol - Enter 6 to 20 characters, including English letters, numbers, and special characters(
$%{}[]"\excluded)
Protocol > Password Confirmation Required Confirm account password - Re-enter the same password
Recovery snapshot name Select Name of the recovery snapshot used when creating the volume - Provide the recovery snapshot name when creating a service through snapshot recovery volume creation
Table. File Storage Service Information Input Items - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
- 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 File Storage List page.
- Regardless of disk type, all volumes have server-side encryption based on the XTS-AES-256 algorithm applied by default.
- The snapshot schedule can be set on the detail page.
View File Storage Details
The File Storage service allows you to view and edit the full resource list and detailed information. The File Storage Details page consists of the Detailed Information, Snapshot List, Replication, Disk Backup, Tags, Operation History tabs.
To view detailed information about the File Storage service, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage list page.
- On the File Storage List page, click the resource to view detailed information. You will be taken to the File Storage Details page.
- File Storage Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Disk Backup, Tags, Job History tabs.
Category Detailed description Volume status Volume status representation - Creating: Creating
- Creating From Snapshot: Creating a new volume from snapshot
- Available: Created, server connection available
- Deleting: Deleting
- Error Deleting: Abnormal state during deletion
- Inactive: Abnormal state
- Error: Abnormal state during creation
- Migrating: Temporary maintenance state
- Migrating To: Temporary maintenance state
- Reverting: Reverting snapshot
- Reverting Error: Snapshot revert error
Clone creation Create a replica at another location - Backups and replicas are unavailable
- For detailed information on creating replicas, see Creating a replica reference
Create disk backup Create a backup copy to store snapshots on backup-dedicated HDD storage - Available for HDD, SSD disk types
- Up to 2 backup copies can be created
- Backup copies and replicas are not available
- For details on creating a disk backup, see 디스크 백업 생성하기 reference
Create snapshot Immediately create a snapshot at the time of creation - For detailed information on snapshot creation, refer to Snapshot Creation
More > Snapshot Recovery Recover the volume using the latest snapshot in Available state - For details on snapshot recovery, refer to Recover Snapshot
More > File-level recovery Enable file-level recovery within snapshots - For detailed information on file-level recovery, see Using file-level recovery.
More > Disable file-level recovery Disable file-level recovery within snapshotsDisable file-level recovery see Service termination Button to cancel the service Table. Status information and additional features
- File Storage Details page displays status information and additional feature information, and consists of Details, Snapshot List, Replication, Disk Backup, Tags, Job History tabs.
Detailed information
On the File Storage List page, you can view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| Service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform
|
| Resource name | Resource Name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation date and time | Service creation timestamp |
| Volume name | Volume name |
| Category | Distinguishing original status for duplication and disk backup |
| Disk type | Disk type |
| Usage | Volume usage |
| Protocol | NFS and CIFS protocols for sharing volumes over the network from a server |
| Mount name | Mount name per volume for server connection
|
| Encryption | Encryption status
|
| Snapshot > Schedule | Snapshot automatic creation schedule
|
| Snapshot > Retention Count | Snapshot retention count
|
| Connection resource | Connected resources (Bare Metal Server, Virtual Server, GPU Server)
|
| VPC Endpoint | Connected VPC Endpoint service
|
Snapshot list
You can view the snapshot of the selected resource on the File Storage List page.
| Category | Detailed description |
|---|---|
| Snapshot usage | Total size of stored snapshots |
| Snapshot name | Snapshot name |
| capacity | Snapshot capacity |
| Creation date and time | Snapshot creation time |
| status | Snapshot status
|
| Additional features > More | Snapshot Management Button
|
- The snapshot creation time is based on Asia/Seoul (GMT +09:00). Snapshots can be created up to a maximum of 800, excluding those generated by schedule. (Automatic creation via schedule is limited to a maximum of 128)
- If replication or disk backup is in use, you cannot delete the snapmirror snapshot.
- When you click the snapshot recovery button, the volume is restored to the latest snapshot in the Available state.
- When selecting to create a recovery volume on the snapshot list page, a new volume based on the snapshot is created without modifying the existing volume.
- The snapshot list can be viewed in both the original and the backup. Replicas can be viewed after the policy is deleted.
- Snapshot creation, recovery, and recovery volume creation are available on the source.
- When using replication or disk backup, you cannot recover with a snapshot; you can only create a recovery volume.
Clone
On the File Storage List page, you can view the replication information of the selected resource.
| Category | Detailed description |
|---|---|
| Replication Policy | User-configured replication policy
|
| Replication cycle | The replication interval of the source set by the user
|
| Replication status | Replication progress status according to policy settings |
| Volume information | Volume information of original and replica
|
- When a clone is created, a replica with the same disk type is generated.
- Replication policy, Replication schedule can be modified in a replica when the replication status is Completed or Stopped.
- The replica’s file-level recovery can be used when the replication status is completed or stopped.
- The replica’s connection server and VPC Endpoint can be modified only when the replication status is stopped.
- Snapshot-related functions for replicas become available after the replication policy is deleted.
Disk backup
File Storage List page allows you to view the disk backup information of the selected resource.
- Disk type must be HDD or SSD; only the original can perform disk backup. It cannot be used on clones or high‑performance SSD.
- You can create up to two backup copies.
| Category | Detailed description |
|---|---|
| Backup Policy | Backup policy set by the user
|
| Backup frequency | User-configured backup interval of the original
|
| Backup status | Backup progress status based on policy settings |
| Number of backup copies | Number of snapshots retained in the backup |
| Volume information | Volume information for original and backup
|
- When creating a backup, it is created as an HDD disk type regardless of the original’s disk type.
- Backup policy, Backup schedule can be modified only when the backup status in the backup set is completed or stopped.
- File-level recovery of a backup can be used when the backup status is Completed or Stopped.
- The backup’s connected server and VPC Endpoint can be modified only when the backup status is stopped.
- Snapshots of the backup can only be deleted.
tag
File Storage List page allows you to view the tag information of the selected resource, and you can add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Work History
File Storage List page lets you view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Managing File Storage Resources
If you need to modify the settings of a created File Storage or add or remove connected servers, you can perform the operation on the File Storage Details page.
Edit Snapshot
You can modify the snapshot schedule and retention count. To edit a snapshot, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- Click the File Storage menu on the Service Home page. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to edit the snapshot settings. You will be taken to the File Storage Details page.
- Click the Edit button of the Snapshot item. Snapshot Edit popup window opens.
- Set the Usage status, Schedule, and Storage Count, then click the Confirm button.
- If you want to automatically create snapshots based on Schedule, select Use.
- Schedule is selected daily, hour-wise, or weekly, day of week, hour-wise.
- Retention count: Enter a number between 1 and 128. If not entered, it defaults to 10.
- If the retention count after modification is lower than the original, older snapshots will be deleted first.
- When set to unused, previously created snapshots are retained.
- Since snapshot storage is included in File Storage usage and incurs charges, adjust the storage capacity by configuring the number of snapshots to retain.
- The snapshot schedule is based on Asia/Seoul (GMT +09:00).
Edit linked resources
You can connect or disconnect resources. To modify a connected resource, follow these steps.
- All Services > Storage > File Storage menu, click it. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource you want to edit. You will be taken to the File Storage Details page.
- Click the Edit button of the Linked Resource item. The Select Linked Resource popup opens.
- After selecting or deselecting the resource, click the Confirm button.
- You can select multiple resources simultaneously.
- You can connect up to 300 resources at the same location. If you need to connect more than 300, use the API.
- When adding a connected server, you can use it after performing the connection tasks (Mount, network drive connection) on the server. For detailed information about server connections, see Connect to Server.
- The replica’s connected server can be modified when the replication status is stopped.
- The backup’s linked server can be modified when the backup status is stopped.
Edit VPC Endpoint
You can connect or disconnect a VPC Endpoint.
To modify the connection resource, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to modify the VPC Endpoint connection. Then go to the File Storage Details page.
- Click the Edit button of the VPC Endpoint item. The Select VPC Endpoint popup window opens.
- After selecting or deselecting the resource, click the Confirm button.
- You can select multiple resources simultaneously.
- Connect to the server and be sure to perform the disconnect operation (Umount, disconnect network drive) before releasing the VPC Endpoint. If you release it without OS operations, a status error (Hang) may occur on the connected server. For detailed information on disconnecting the server, see 서버 연결 해제하기.
- High‑performance SSD disks can also share data by connecting a VPC Endpoint, but be aware that they do not guarantee sufficient performance for connecting internal VPC resources.
- High‑performance SSD disk type: after checking the connection IP in the VPC Endpoint section, apply for the VPC Endpoint service. You can add a VPC Endpoint created based on the connection IP.
- The VPC Endpoint of a replica can be modified only when the replication status is stopped.
- The VPC Endpoint of the backup can be modified only when the backup status is stopped.
Cancel File Storage
You can reduce operating costs by terminating unused File Storage. However, terminating the service may cause the running service to stop immediately, so you should thoroughly consider the impact of service interruption before proceeding with the termination.
- Please note that data cannot be recovered after termination.
- You can cancel the service of a File Storage volume that has no attached resources. Remove all connected servers before canceling the service.
- You can terminate the service for a File Storage volume that does not have a VPC Endpoint connection. Remove all VPC Endpoints before terminating the service.
- If the volume is in the Available, Error, or Inactive state, it can be deleted.
- The original that is using replication or disk backup can be terminated after deleting the corresponding policy.
- Replication policy: pause > delete
- Backup policy: pause > service termination
- A replica can be terminated after the replication policy is deleted.
- Backup copies can be terminated after the backup policy is stopped.
To cancel File Storage, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage list page, select the resource to cancel and click the Cancel Service button.
- When termination is complete, verify on the File Storage List page whether the resource has been terminated.
2.1 - Connect to Server
When using a volume on the server, a connect or disconnect operation is required.
File Storage Details on the page, after adding a connected server, access the server and perform the connection tasks (Mount, network drive connection). After use, perform the disconnection tasks (Umount, disconnect network drive) and then remove the connected server.
Connect to server (Mount, network drive connection)
To use the volume added to the connected server, you must log into the server and perform the connection tasks (Mount, network drive connection). Follow the steps below.
Linux operating system (NFS)
- Mount information: 10.10.10.10:/filestorage
- Mount location: /data
Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
On the File Storage List page, click the resource to be used on the connected server. You will be taken to the File Storage Details page.
Check the server in the Connection Server item and then connect.
Refer to the procedure below to mount the volume.
Switch to root privileges
$ sudo -iPackage installation (Redhat family)
# yum install nfs-utilsPackage installation (Debian-based)
# apt-get install nfs-commonEnable and start NFS-related daemon
# systemctl enable rpcbind.service # systemctl start rpcbind.serviceVolume Mount
# mkdir /data # mount -t nfs -o vers=3,noresvport 10.10.10.10:/filestorage /data # vi /etc/fstab (추가) 10.10.10.10:/filestorage /data nfs defaults,vers=3,_netdev,noresvport 0 0
- Supports NFS Version 3.
Windows operating system (CIFS)
Click the All Services > Storage > File Storage menu. Go to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
On the File Storage List page, click the resource to be used on the connected server. You will be taken to the File Storage Details page.
In the Connection Server item, verify the server and then connect.
Refer to the steps below to connect the volume (network drive).
- In File Explorer, right-click This PC and click Connect network drive.
- Refer to the detailed information of the File Storage volume to be connected, enter the drive and folder, and then click Finish.
- To set it to reconnect automatically when the server restarts, select Reconnect when logging in.
In the network credential input popup, enter the account name (ID) and password, then click Confirm.
- Check the account name (ID) on the File Storage Details page.
- The password is the password set during File Storage creation.
- If you connect two or more volumes with the CIFS protocol enabled, add the storage IP and storage name to the hosts file before connecting.
* Mount명 \\10.10.10.10\filestorage1 \\10.10.10.10\filestorage2 * hosts 파일 내용 추가 10.10.10.10 filestoragename1 #설명 10.10.10.10 filestoragename2 #설명 * hosts 파일에 작성된 이름 사용 filestorage1 연결 시: \\ filestoragename1\filestorage1 filestorage2 연결 시: \\ filestoragename2\filestorage2
Disconnect server (Umount, disconnect network drive)
After connecting to the server and performing the disconnect tasks (Umount, disconnecting the network drive), you must detach the server in the Console. Follow the steps below.
Linux operating system (NFS)
Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
On the File Storage List page, click the resource to detach the connected server. Go to the File Storage Details page.
In the Connection Server field, verify the server information and then connect to the server.
Refer to the commands listed in the table below to carry out the unmount (Umount) operation.
- Volume Umount
# umount /data # vi /etc/fstab (삭제) 10.10.10.10:/filestorage /data nfs defaults,vers=3,_netdev,noresvport 0 0
- Volume Umount
Windows operating system (CIFS)
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to disconnect the server. Navigate to the File Storage Details page.
- In the Connection Server field, verify the server information and then connect to the server.
- Refer to the steps below to disconnect the volume (disconnect the network drive).
In
File Explorer, right-click thenetwork drivethat is already connected.Please select
Disconnect network drive
2.2 - Use Snapshot
You can create, delete, or restore snapshots of a created File Storage. You can perform these actions on the File Storage Details page and the Snapshot List page.
Create Snapshot
You can create a snapshot of the current point in time immediately. To create a snapshot, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- File Storage List page, click the resource to create a snapshot. You will be taken to the File Storage Details page.
- Click the Snapshot Creation button. A popup indicating snapshot creation will open.
- Click the Confirm button. Creating a snapshot.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- Check the generated snapshot.
- Snapshot charges are included in the File Storage usage fees.
- When using replication or disk backup, you cannot recover with a snapshot; you can only create a recovery volume.
- The snapshot creation time is based on Asia/Seoul (GMT +09:00). Snapshots can be created up to 800, excluding those generated by schedule. (Automatic creation via schedule is limited to 128)
- If you want to automatically generate snapshots using a schedule, configure snapshots on the File Storage Details page.
- For detailed information about the snapshot schedule, see Update Snapshot.
Recover Snapshot
You can restore a File Storage volume to the latest snapshot in the Available state. To restore a snapshot, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to restore from a snapshot. You will be taken to the File Storage Details page.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- Check the latest snapshot in the Available state. The volume will be restored using that snapshot.
- Click the snapshot recovery button. A popup indicating snapshot recovery will open.
- After checking the snapshot name and creation timestamp, click the Confirm button.
- When recovery starts, it becomes Reverting, and when completed, it becomes Available.
- If you want to restore from a snapshot that is not the latest, you can recover by creating a recovery volume.
- During recovery, it restores from the latest snapshot in the Available state, and recovery is not possible in the following situations.
- When the File Storage volume is not in the Available state.
- If there are no recoverable snapshots.
- If the latest snapshot changes while creating a recovery.
- If the latest snapshot is not in the Available state.
Create a snapshot recovery volume
You can create a volume using a snapshot. To create a snapshot recovery volume, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to restore from a snapshot. You will be taken to the File Storage Details page.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- After checking the Snapshot Name and Creation Time, click the More button of the snapshot you want to restore.
- Click Create Recovery Volume. A popup window indicating the creation of a snapshot recovery volume opens.
- Click the Confirm button. Go to the File Storage creation page.
- On the File Storage creation page, enter the information required to create the service, and select detailed options.
- Please enter the volume name and password.
- The disk type and protocol are set to match the original and cannot be modified.
Category Required or notDetailed description Volume name Required Volume name - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
_)
- is generated as ‘user input value + {6-character UUID composed of lowercase English letters and numbers}’
- cannot be modified after the service is created
Disk type Required Select disk type - HDD: Standard volume
- SSD: High‑performance standard volume
- Cannot be modified after service creation
- When creating a service via snapshot recovery volume, it is set identical to the original and cannot be modified
Protocol Required Protocols for sharing volumes over the network from a server - NFS: primarily used on Linux operating systems
- CIFS: primarily used on Windows operating systems
- When creating a service, the snapshot recovery volume is set identical to the original and cannot be modified
Protocol > Password Required Set the account password for volume access when using the CIFS protocol - Enter 6~20 characters, including English letters, numbers, and special characters(
$%{}[]"\excluded)
Protocol > Password Confirmation Required Confirm account password - Re-enter the same password
Recovery snapshot name Select Name of the recovery snapshot used when creating the volume - Provide the recovery snapshot name when creating a service via snapshot recovery volume creation
Table. File Storage Service Information Input Items - must start with a lowercase English letter and be 3 to 21 characters using lowercase letters, numbers, and special characters (
- Check the detailed information and estimated billing amount generated in the Summary panel, and click the Create button.
- When creation is complete, check the created resource on the File Storage List page.
Delete snapshot
You can select a snapshot to delete. To delete a snapshot, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to delete the snapshot. Go to the File Storage Details page.
- Click the Snapshot List button. You will be taken to the File Storage Snapshot List page.
- After checking the snapshot name and creation timestamp, click the More button of the snapshot you want to delete.
- Click the Delete button. The snapshot will be removed from the Snapshot List page.
- When using replication, snapmirror files cannot be deleted.
2.3 - File-level Recovery
You can restore data file by file using the generated snapshot. You can perform the operation on the File Storage Details page.
Using file-level recovery
You can enable the file-level recovery feature for use. After enabling the feature, connect to the server to select and recover data. To perform file-level recovery, follow these steps.
Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
On the File Storage List page, click the resource to restore the file. You will be taken to the File Storage Details page.
Click the More button at the top right, then click the File-level Recovery button. The Enable File-level Recovery popup window opens.
Click the Confirm button. Activates the file-level recovery feature.
- When File-level recovery is enabled, the File-level recovery button is displayed as Disable file-level recovery.
In the Connection Server field, verify the server information and then connect to the server.
Refer to the procedure below to recover the data.
Connect to the server and verify the mount name of the File Storage.
Move to the snapshot location under the mount name.
# cd /Mount명/.snapshot/snapshot명- Check the files to be restored at the snapshot location and restore them to the required path.
Disable file-level recovery
You can disable the file-level recovery feature after using it. To disable file-level recovery, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage list page.
- On the File Storage List page, click the resource to disable file-level recovery. You will be taken to the File Storage Details page.
- Click the More button at the top right, then click the Disable File-Level Recovery button. The Disable File-Level Recovery popup will open.
- Click the Confirm button. Disable the file-level recovery function.
2.4 - Use Disk Backup
After creating a backup of File Storage on a backup-dedicated HDD Storage, you can periodically store snapshots. You can perform the tasks on the File Storage Details page and the Disk Backup page.
- Disk type must be HDD or SSD for disk backup to be possible from the original. It cannot be used with clones or high‑performance SSD.
- You can create up to two backup copies.
Create Disk Backup
You can create a backup volume on a backup-dedicated HDD storage at the original location or elsewhere.
To create a backup volume, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage list page.
- On the File Storage List page, click the resource to create a backup. Go to the File Storage Details page.
- Click the Create Disk Backup button. The Create Disk Backup popup window opens.
- After entering the backup information, click the Create button. It creates a backup of the HDD disk type.
- Backup Location: Select the location where the backup will be created.
- Backup Frequency: Choose from 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Click the Disk Backup page. Navigate to the Disk Backup page.
- disk backup information, please check.
- When selecting the volume name of the original or backup, you are taken to the File Storage Details page of that volume.
- A backup in HDD format is created regardless of the original disk type.
- You can create up to two backups per volume, and inter‑region backups incur additional data transfer charges.
Modify Disk Backup Policy
You can change the backup status by modifying the backup policy. To modify the backup policy, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage list page.
- On the File Storage List page, click the resource to edit the backup policy. You will be taken to the File Storage Details page.
- Click the Disk Backup tab.
- Click the Edit button of the Backup Policy. The Disk Backup Policy Edit popup window opens.
- Enabled: Performs backup. If Paused, you can change it to Enabled.
- Pause: Temporarily stops the backup. If Enabled, you can modify to Pause.
- Delete: Deletes the backup. If it is Paused, it can be changed to Delete, and after deletion the backup cannot be used again.
- Check the updated backup policy on the Disk Backup page of File Storage.
Modify Disk Backup Schedule
You can change the synchronization interval between the original and the backup by modifying the backup schedule. To modify the backup schedule, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Navigate to the File Storage list page.
- File Storage List page, click the resource whose backup schedule you want to edit. You will be taken to the File Storage Details page.
- Click the Disk Backup page.
- Click the Edit button of Backup schedule. Backup schedule edit popup window opens.
- Select Backup frequency from 1 hour, daily, weekly, or monthly. Snapshots will be created at the selected interval. * Daily: 23:59:00 * Weekly: Every Sunday 23:59:00 * Monthly: 1st day of each month 23:59:00
- Check the updated backup schedule on the Disk Backup page of File Storage.
Modify the number of retained disk backups
You can set the number of snapshots retained in the backup. To modify the backup retention count, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. You will be taken to the File Storage List page.
- On the File Storage List page, click the resource to modify the backup schedule. You will be taken to the File Storage Details page.
- Click the Disk Backup page.
- Click the Edit button of Backup retention count. The Edit disk backup retention count popup opens.
- Backup retention count Please enter. * The retention count can be set from 1 to 128.
- Check the modified backup schedule on the Disk Backup tab of the File Storage Details page.
2.5 - Use Replication
You can create a replica of the File Storage at another location and synchronize it periodically. You can perform the tasks on the File Storage Details page and the Replication page.
- The kr-south region does not provide File Storage replication functionality.
Create Clone
You can create a replica volume at a different location. To create a replica volume, follow the steps below.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Go to the File Storage List page.
- On the File Storage List page, click the resource for which you want to create a replica. You will be taken to the File Storage Details page.
- Click the Create Clone button. The Create Clone popup window opens.
- Enter the replication location, replication volume name, password, and replication interval, then click the Create button. It creates a replica with the same disk type.
- Replication location: Choose a location different from the original File Storage volume.
- Replication Volume Name: Begin with a lowercase English letter and use lowercase letters, numbers, and special characters (
_) to enter 3–21 characters. - Password: This is the account password for accessing a CIFS volume. Enter 6 to 20 characters, including letters, numbers, and special characters (
$%{}[]"\excluded). - Replication interval: Select from 5 minutes, 1 hour, daily, weekly, monthly. Replication will be performed using the interval below.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Click the Clone page. You will be taken to the Clone page.
- Check the replication information.
- When selecting the volume name of the original or replica, you are taken to the volume’s File Storage Details page.
- When creating a replica, a replica with the same disk type and protocol is created.
- You can create one replica per volume, and data transfer charges apply for cross‑region replication.
Edit replication policy
You can change the replication status by modifying the replication policy. To modify the replication policy, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Navigate to the File Storage list page.
- On the File Storage List page, click the resource to edit the replication policy. You will be taken to the File Storage Details page.
- Click the Replication page. Navigate to the File Storage Replication page.
- Click the Edit button of the Replication Policy. The Edit Replication Policy popup window opens.
- Use: performs replication. If it is Paused, you can change it to Use.
- Pause: Temporarily pauses replication. If enabled, you can modify it to Pause.
- Delete: Delete the replica. If it is Paused, you can modify it to Delete, and after deletion you cannot use replication again.
- Check the updated Replication Policy on the File Storage Replication page.
- After deletion, the replica becomes the original, so you cannot replicate back to the previous configuration by modifying the replication policy.
- Data stored only in the replica after a pause will be deleted when replication is used again.
- When using the replication policy, replicas are in read‑only state and data cannot be modified. Unmount from all connected resources before using replication.
- If the replication policy is stopped or the replication status is completed, you can modify the policy and schedule on the replica.
Edit replication cycle
You can change the synchronization interval between the original and the replica by modifying the replication interval. To modify the replication interval, follow these steps.
- Click the All Services > Storage > File Storage menu. Navigate to the Service Home page of File Storage.
- On the Service Home page, click the File Storage menu. Navigate to the File Storage list page.
- On the File Storage List page, click the resource to edit the replication schedule. You will be taken to the File Storage Details page.
- Click the Replication page. Go to the File Storage Replication page.
- Click the Edit button of Replication Cycle. The Edit Replication Cycle popup opens.
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- Daily: every day 23:59:00
- Weekly: Every Sunday 23:59:00
- Monthly: 1st day of each month 23:59:00
- Replication interval: Select from 5 minutes, 1 hour, daily, weekly, or monthly. Replication will be performed at the selected interval.
- On the File Storage Replication page, check the modified replication schedule.
- If the replication policy is stopped or the replication status is completed, you can modify the policy and interval on the replica.
3 - API Reference
4 - CLI Reference
5 - Release Note
File Storage
- The SSD SAP_E volume dedicated to SAP Account and the SSD SAP_E disk type have been added.
- When using a volume dedicated to the SAP Account, the LIF (storage Mount IP) is automatically transferred when a failover occurs due to a fault.
- It can be used only with a SAP account.
- ServiceWatch service integration provision
- You can monitor data through the ServiceWatch service.
- High‑performance SSD disk type has been added and can be used by connecting to a Multi-node GPU Cluster.
- Disk Backup allows you to store snapshots on a backup-dedicated HDD storage. You can select a location other than the original.
- File Storage feature change
- SSD disk types have been added, enabling you to choose a disk type according to your needs.
- You can create an identical replica volume at a different location and set the data replication interval.
- File Storage can be accessed from external networks via a VPC Endpoint connection.
- Samsung Cloud Platform Common Feature Changes
- Account, IAM, Service Home, tags, and other common CX changes have been applied.
- Since it automatically scales up or down based on usage, users can use the volume without capacity limits.
- You can select the connection target using the access control feature.
- We have launched the File Storage service, a network‑connected storage that enables multiple client servers to share files.
