Object Storage

• 1: Overview
• 1.1: Amazon S3 Usage Guide
• 1.2: Monitoring Metrics
• 1.3: ServiceWatch metric
• 2: How-to guides
• 2.1: Access control
• 2.2: File and Folder Management
• 2.3: Version Management
• 2.4: Permission Management
• 2.5: Replication Policy Management
• 2.6: Copy original file
• 3: Release Note

1 - Overview

Service Overview

Object Storage is an object storage that allows users to easily store and use the data they want and can be accessed via URL, making data management very convenient. It enables searching and retrieving large-scale data, and you can leverage features such as encryption and version control. Provides public and private URLs, and the public URL can be accessed over the internet.

Features

• Using S3 API: Through a Restful API, applications can access it easily and quickly, and because it is compatible with Amazon S3, it can be used effortlessly in applications integrated with Amazon S3.
• Secure Use: Encryption (SSE‑S3), access control, and Public/Private access features are provided, making it suitable for safely storing user data or backup data for service recovery.
• Cost Efficiency: Users do not predefine the bucket capacity and are provided storage space with an efficient pricing model that charges only for the amount used.
• Replication: You can perform replication 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 service through the replica bucket.

Configuration diagram

Provided Features

Object Storage provides the following features.

• Storage Management: Provides Object Storage creation, folder creation, folder deletion, file upload, file download, and file deletion functions.
• Version control: When you use version control, all versions of uploaded files are managed. * You can easily download previous files by viewing the version list.
• Encryption: If you enable encryption, encryption is provided using the SSE‑S3 method.
• Access Control: Using access control, you can directly enter the public IPs allowed to access Object Storage, or select resources within the same account (Virtual Server, Bare Metal Server, VPC Endpoint, etc.) that are permitted to access it.
• Replication: You can perform replication to a bucket in a different location or the same location.
  • Multiple replication policies can be configured
• Permission Management: It is provided with Private permission by default, and offers Public permission and permission management features.
  • Private permission: Allow file access and download only to users who know the authentication key.
  • Public permission: If accessed via the file’s URL, the file is made public and downloadable to anyone worldwide.
• Monitoring: You can view monitoring information such as total file count, data size (Bytes), and HTTP method request counts through the Cloud Monitoring service.
• ServiceWatch Service Integration Provision: You can monitor data through the ServiceWatch service.

Component

authentication key

The authentication key is a required element that must be created in advance for using Object Storage.
The purpose of using the authentication key is as follows.

• In the Samsung Cloud Platform Console, you need an authentication key to create and access the Object Storage service.
• The API provided by Object Storage is compatible with Amazon S3, and you can use the same tools that leverage Amazon S3. * At this point, entering an authentication key is required, and it is used as a tool to identify whether the user has the appropriate permissions. For detailed instructions on creating and verifying authentication keys, see How-to guides > 인증키 생성하기.

Bucket

A bucket is the top-level folder, and all folders and files exist under the bucket. When you create an Object Storage service in the Samsung Cloud Platform Console, a bucket is created, and you can subsequently upload folders or files.
The bucket name creation rules are as follows.

• Bucket names must be at least 3 characters and no more than 63 characters.
• Bucket names can consist only of lowercase English letters, numbers, periods. and hyphens-.
• Bucket names must start with a lowercase letter or a digit.
• Bucket names must not contain two consecutive periods.
• Bucket names cannot end with a period or hyphen.
• Bucket names cannot have a period and hyphen adjacent to each other.
• Bucket names do not use the IP address format (e.g., 192.168.x.x).
• You cannot use admin as a bucket name.
• The bucket name must be unique within an Account/Region.
• The bucket name you previously used will be available in 1 hour.

Folder

Folder (Folder) is used to logically group files.
The folder name generation rules are as follows.

• Folder names can consist of Korean characters, English letters, numbers, and special characters.
• The special characters that cannot be entered are as follows.

File

A file (File) refers to data stored in Object Storage and is the same as a regular file.
The filename generation rules are as follows.

• Filenames can consist of Korean characters, English letters, numbers, and special characters.
• The special characters that cannot be entered are listed below.

Folder names and file names are separated by a slash/. The following are examples of valid folder names and file names.

URL

You can access the Object Storage bucket via URL. By providing both public and private URLs, access is possible not only within the same Samsung Cloud Platform environment but also from external internet environments.
The URL structure is organized as follows.

The full URL information for the file can be found in 파일 정보 조회하기.

Constraints

The limitations of Object Storage are as follows.

Preliminary Service

Object Storage has no prerequisite services.

1.1 - Amazon S3 Usage Guide

Object Storage provides functions such as creating services, viewing lists, retrieving folder lists, creating folders, uploading files, and downloading files through the Samsung Cloud Platform Console. These features are also provided via an API compatible with Amazon S3. Therefore, tools that utilize Amazon S3 can be used in the same way.
Using Amazon S3’s utility tools requires generating and verifying an authentication key. For detailed information, please refer to 인증키 생성하기.

Amazon S3 API

The list of Amazon S3 APIs supported by the Samsung Cloud Platform Object Storage service is as follows.

Bucket policy creation example

When using put-bucket-policy, refer to the following example to write the JSON file.

{
    "Statement": [
        {
            "Action": "s3:*"
            "Condition": {
                "IpAddress": {
                    "scp:SourceIp": []
                },
                "Resource": {
                    "scp:SourceDBaaSId": [],
                    "scp:SourceResourceId": [],
                    "scp:SourceVpcEndpointId": []
                },
                "Service": {
                    "scp:ServiceAiTraining": "true",
                    "scp:ServiceScf": "false"
                }
            },
            "Effect": "Allow"
            "Principal": "*"
            "Resource": [
                srn:e::1234:kr-west1::objectstorage:bucket/bucketname
                srn:e::1234:kr-west1::objectstorage:bucket/bucketname/*
            ]
        }
    ],
    "Version": "2012-10-17"
}

{
    "Statement": [
        {
            "Action": "s3:*"
            "Condition": {
                "IpAddress": {
                    "scp:SourceIp": []
                },
                "Resource": {
                    "scp:SourceDBaaSId": [],
                    "scp:SourceResourceId": [],
                    "scp:SourceVpcEndpointId": []
                },
                "Service": {
                    "scp:ServiceAiTraining": "true",
                    "scp:ServiceScf": "false"
                }
            },
            "Effect": "Allow"
            "Principal": "*"
            "Resource": [
                srn:e::1234:kr-west1::objectstorage:bucket/bucketname
                srn:e::1234:kr-west1::objectstorage:bucket/bucketname/*
            ]
        }
    ],
    "Version": "2012-10-17"
}

• Action, Effect, Principal cannot be modified.
• Enter the Object Storage SRN and Object Storage SRN/* in Resource.
• Condition’s IpAddress, Resource, Service can be modified as follows.
  • IpAddress: Enter a single IP or CIDR format.
  • Resource: Enter each resource ID.
  • Service: Enter false or true.
  • For detailed information about permissible targets, refer to Setting Access Control.

Bucket replication policy creation example

put-bucket-replication, when using it, refer to the following example to create the JSON file.

{
    "Role": "srn:e::1234:::iam:user/abc3d3442"
    "Rules": [
        {
            "ID": "replication-policy-1"
            "Status": "Enabled",
            "Priority": 1,
            "DeleteMarkerReplication": {
                "Status": "Enabled"
            },
            "Filter": {
                "Prefix": ""
            },
            "Destination": {
                "Bucket": "srn:e::1234:kr-west1::objectstorage:bucket/bucketname"
            }
        }
    ]
}

{
    "Role": "srn:e::1234:::iam:user/abc3d3442"
    "Rules": [
        {
            "ID": "replication-policy-1"
            "Status": "Enabled",
            "Priority": 1,
            "DeleteMarkerReplication": {
                "Status": "Enabled"
            },
            "Filter": {
                "Prefix": ""
            },
            "Destination": {
                "Bucket": "srn:e::1234:kr-west1::objectstorage:bucket/bucketname"
            }
        }
    ]
}

• Role: Enter the IAM SRN.
• Rules > Destination’s Bucket: Please enter the Bucket SRN.
• If you do not provide the ID of Rule, it will be automatically generated with a random value.
• If you change the ID of Rule, a new policy is created and the existing policy is deleted.

Amazon S3 CLI

To use Amazon S3 with the AWS CLI, refer to the Amazon S3 CLI Guide.

Amazon S3 SDK for Java

To use the Amazon S3 SDK for Java, refer to the Amazon S3 SDK Guide.

1.2 - Monitoring Metrics

Object Storage Monitoring Metrics

The table below shows the monitoring metrics for Object Storage that can be viewed through Cloud Monitoring. For detailed usage of Cloud Monitoring, refer to the Cloud Monitoring guide.

1.3 - ServiceWatch metric

Object Storage sends metrics to ServiceWatch. The metrics provided by basic monitoring are data collected at 5‑minute intervals. In Object Storage, you can view replication metrics for each replication policy in ServiceWatch by enabling replication metrics per bucket.

Refer to How-to guides > Object Storage 복제 지표 활성화하기 for how to enable ServiceWatch replication metrics.

Basic Metrics

The following are basic metrics for the Object Storage namespace.

The indicators whose names are displayed in bold below are the indicators selected as key among the basic metrics provided by Object Storage. The key metrics are used to build service dashboards that are automatically created for each service in ServiceWatch.

Each metric provides guidance in the user guide on which statistical values are meaningful when querying that metric, and among the meaningful statistics, the values displayed in bold are the primary statistics. In the service dashboard, you can view key metrics through primary statistical values.

Replication metric

The following are replication metrics. Replication metrics are collected per replication policy. Replication metrics are collected only when ServiceWatch replication metrics are enabled for each bucket. The replication metrics are as follows.

2 - 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 need to generate an authentication key in advance.

Generating an authentication key is My menu > My Info. > Authentication Key Management > Authentication Key Creation can be created from . For more details, please refer to IAM > 인증키 생성하기.

Create Object Storage

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

To create an Object Storage, follow the steps below.

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Create Object Storage button. 2. Go to the Create Object Storage page.
3. Object Storage Creation page, enter the information required to create the service.

   Category	Required status	Detailed description
   Bucket name	Required	Bucket name created by the user must start with a lowercase letter or digit and be entered using lowercase letters, digits, hyphen-, period., with a length of 3 to 63 characters A period. cannot appear consecutively two or more times. A period. and hyphen- cannot be adjacent. A period. or hyphen- cannot be at the end. IP address format is not allowed admin name is not allowed For detailed information about bucket naming, refer to 버킷명 생성 규칙.

   Table. Object Storage required information input fields

4. Summary Verify the detailed information and estimated charges generated in the panel, then click the Create button.
   • When creation is complete, check the created resources on the Object Storage List page.

View Object Storage detailed information

You can view and edit the full list of resources and detailed information for the Object Storage service.
The Object Storage Details page consists of the Details, Folder List, Replication, Original File Copy, and Tags tabs.

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

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Click the resource to view detailed information on the Object Storage list page. 3. Navigate to the Object Storage Details page.
   • The Object Storage Details page displays status information and additional feature information, and consists of Details, Folder List, Replication, Original File Copy, Tags tabs.

     Category	Detailed description
     Bucket status	Bucket status Active: Available
     Service cancellation	Button to cancel the service

     Table. Status information and additional functions

Detailed Information

Object Storage list page allows you to view detailed information of the selected resource and, if needed, modify the information.

Folder list

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

Replication

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

Copy original file

On the Object Storage List page, you can view and manage the list of original file copy tasks and information for the selected resources.

Tag

On the Object Storage List page, you can view the tag information of the selected resource, and add, modify, or delete it.

Object Storage Encryption Configuration

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

Object Storage To use bucket encryption, follow the steps below.

1. All Services > Storage > Object Storage menu, click it. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage List page, click the resource (bucket) to use encryption. 3. Go to the Object Storage Details page.
4. On the Object Storage Details page, verify that Encryption is Not Used.
5. If Encryption is Unused, click the Edit button. The Encryption Edit Popup opens.
6. After checking Enable for Encryption, click the Confirm button.

Terminate Object Storage

You can cancel unused Object Storage to reduce operating costs. However, if you terminate the service, the running service may be stopped immediately, so you should proceed with the termination only after fully considering the impact that may arise from the service interruption.

To cancel Object Storage, follow the steps below.

1. All Services > Storage > Object Storage menu, click it. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage List page, select the resource (bucket) to terminate, and click the Terminate Service button.
4. Please enter the bucket name to confirm cancellation.
5. If you entered the bucket name correctly, the Confirm button will be enabled. 5. Click the Confirm button.
6. After termination is complete, check the Object Storage list page to see if the resource has been terminated.

2.1 - Access control

When you configure a bucket with access control enabled, only resources that are granted permission can access the bucket. Enter a public IP, or configure settings to allow access to resources created in the Samsung Cloud Platform Console.

Setting Access Control

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

Object Storage Follow these steps to configure access control settings.

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage list page, click the resource (bucket) for which you want to configure access control. 3. Go to the Object Storage Details page.
4. On the Object Storage Details page, verify that Access Control is Not Used.
5. If Access control is unused, click the Edit button. 5. Edit Access Control The popup window opens.
6. After checking the use of access control, click the Confirm button. 6. On the Object Storage Details page, Access Control will be changed to enabled.
   • If you change access control to Enabled, you can set access control for Public IP, service resources, Cloud Functions, Simple AI Training services.
7. Click the Edit button of the resource or service you want to allow access to, to add resources or set whether to allow them.

   Category	Detailed description
   Allow public IP	Registered Public IP or CIDR list Example: 192.168.x.x, 192.168.x.x/24 For detailed information on allowing Public IP access, see Public IP 접근 허용하기
   Allow service resources	List of service resources created in the same Account/Region Service examples: Virutal Server, GPU Server, Bare Metal Server, Multi-node GPU Cluster, VPC Endpoint, PostgreSQL, MariaDB, MySQL, EPAS, Microsoft SQL Server For detailed information on allowing access to service resources, see 서비스 자원 접근 허용하기
   Cloud Functions service	Set whether to allow Object Storage access for modifying Java Runtime code in the Cloud Functions service Allow when set, the Cloud Fuctions service can load Java Runtime executable files stored in Object Storage For detailed information about allowing the Cloud Functions service, see Cloud Functions 서비스 접근 허용하기
   Simple AI Training Service	Set whether to allow Object Storage access for retrieving the Training Script in the Simple AI Training service Allow when set, the Simple AI Training service can retrieve the Training Script stored in Object Storage For more details about enabling the Simple AI Training service, see Simple AI Training 서비스 접근 허용하기

   Table. Access control items

Allow public IP access

If the bucket’s access control is set to enabled, you can add a Public IP allowance. To enable Public IP access from Object Storage, follow these steps.

1. All Services > Storage > Object Storage Click the menu. 1. Navigate to the Service Home page.

2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.

3. On the Object Storage List page, click the resource (bucket) you want to set access control for. 3. Go to the Object Storage Details page.

4. Object Storage Details On the page, verify that access control is enabled.

   • If Access Control is Unused, click the Edit button, then in the Access Control popup, change Access Control to Enabled.
   • Access control can control access to IP access allowed, service resource allowed, Cloud Functions service, Simple AI Training service only when enabled.

5. Click the Edit button in Public IP Allow. 5. Public IP Allow Edit A popup window opens.

6. Enter the Public IP to allow access, and click the Add button. 6. The entered IP appears in the IP to add list.

   column	Required	Detailed description
   Allow public IP	Essential	Enter a single IP or CIDR format 192.168.x.x (IP format) 192.168.x.x/24 (CIDR format) Up to 150 entries can be entered

   Table. Public IP Allowance Edit Popup Input Items

7. After checking the IP to add list, press the Confirm button.

8. On the Object Storage Details page, check the added Public IP in the Access Control > Allow Public IP list.

Allow access to service resources

If access control on the bucket is set to enabled, you can add a service resource in the allowed service resources. Follow the steps below to allow access to service resources from Object Storage.

1. All Services > Storage > Object Storage menu, click it. 1. Service Home Go to the page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage List page, click the resource (bucket) for which you want to configure access control. 3. Go to the Object Storage Details page.
4. Verify that Access Control is enabled on the Object Storage Details page.
   • If Access Control is Unused, click the Edit button, then in the Access Control popup, change Access Control to Enabled.
   • Access control can regulate access to IP access allowed, service resource allowed, Cloud Functions service, and Simple AI Training service only when it is enabled.
5. Click the Edit button in Service Resource Allowance. 5. Select Service Resources The popup window opens.
6. Select Service Resources In the popup window, select the service to grant access to, then select the resources to allow.

7. After you finish selecting the resources to allow access, press the Confirm button.
8. Check the resources you added in the Access Control > Service Resource Allow list on the Object Storage Details page.

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. All Services > Storage > Object Storage Click the menu. 1. Navigate to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage List page, click the resource (bucket) you want to configure access control for. 3. Go to the Object Storage Details page.
4. Object Storage Details On the page, check that access control is enabled.
   • If Access Control is Unused, click the Edit button, then in the Access Control popup window, change Access Control to Enabled.
   • Access can be controlled for IP access allowed, service resource allowed, Cloud Functions service, and Simple AI Training service only when access control is enabled.
5. Click the Edit button of the Cloud Functions service. 5. Cloud Functions Service Edit A popup window opens.
6. After checking Allow, click the Confirm button.

Simple AI Training Allow Service Access

If access control for the bucket is set to enabled, you can allow the Simple AI Training service to access Object Storage.

If you want to permit access to the Simple AI Training service from Object Storage, follow the steps below.

1. Click the All Services > Storage > Object Storage menu. 1. Go to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage List page, click the resource (bucket) for which you want to configure access control. 3. Object Storage Details Navigate to the page.
4. Object Storage Details Verify that access control is enabled on the page.
   • If Access Control is Unused, click the Edit button, then in the Access Control popup, change Access Control to Enabled.
   • When access control is enabled, you can control access to IP access allowed, service resource allowed, Cloud Functions service, and Simple AI Training service.
5. Click the Edit button of Simple AI Training Service. 5. Simple AI Training Service Edit A popup window opens.
6. After checking Allow, click the Confirm button.

2.2 - File and Folder Management

If you need to manage the created Object Storage, such as saving files to it or downloading stored files, you can perform tasks 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 the steps below.

1. All Services > Storage > Object Storage Please click the menu. 1. Go to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go 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. 3. Navigate to the Object Storage Details page.
4. Folder List Click the tab. 4. Navigate to the Folder List page.
5. Click the New Folder button. 5. New Folder The popup window opens.
6. Enter the folder name to use, and click the Confirm button. 6. A popup window notifying the creation of a new folder opens.

7. After clicking the Confirm button, check the created folder in the Folder List.

Upload File

You can upload a new file or a file in progress to the bucket. Object Storage Follow the steps below to upload files.

1. All Services > Storage > Object Storage menu, please click. 1. Go to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage List page, click the resource (bucket) to upload files. 3. Object Storage Details Navigate to the page.
4. Click the Folder List tab. 4. Navigate to the Folder List page.
5. Click the File Upload button. 5. File Upload popup window opens.
6. After clicking the Attach File button, select the file to upload or drag and drop the file to attach into the popup window.
   • Connection test button can be clicked to verify the connection.

7. If you have selected all files, click the Upload button.
8. If the upload was successful, check the file in the folder list.

Download File

You can download files stored in the bucket. Object Storage Follow the steps below to download the file.

1. All Services > Storage > Object Storage menu, click it. 1. Navigate to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage List page, click the resource (bucket) you want to download. 3. Object Storage Details Go to the page.
4. Click the Folder List tab. 4. Go to the Folder List page.
5. Click the More > Download button located at the far right of the file to be downloaded. 5. The file download is starting.
6. Check whether the file download has completed in the browser.

Query File Information

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

1. All Services > Storage > Object Storage menu, please click. 1. Navigate to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage List page, click the resource (bucket) that contains the file you want to view information for. 3. Navigate to the Object Storage Details page.
4. Click the Folder List tab. 4. Go 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. 5. File Information The popup window opens.
6. File Information View detailed file information in the popup window.

   Category	Detailed description
   Filename	File name
   Content type	Object type
   Total size	File size
   Modification date and time	The file’s most recent modification timestamp
   Permission	Allow Public Access
   URL	Provide Public and Private addresses to access the file path via URL Public: Provided to be accessible from external internet network 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. 1. Go to the Object Storage List page.
2. On the Object Storage List page, click the resource (bucket) to copy the file. 2. Go to the Object Storage Details page.
3. Click the Folder List tab. 3. Navigate to the Folder List page.
4. Click the More > Copy File button at the far right of the file to be copied. 4. File Copy a popup window opens.
5. Enter the File name, then click the Confirm button. 5. A popup window indicating file copy opens.

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

1. All Services > Storage > Object Storage menu, click it. 1. Go to the Service Home page.
2. On the Service Home page, click the Object Storage menu. 2. Go 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. 3. Object Storage Details Go to the page.
4. Click the Folder List tab. 4. Go 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. 5. Delete popup window opens.
   • After selecting multiple files or folders in the left checkbox, you can delete multiple files or folders at once by clicking the Delete button at the top.
6. In the delete popup, click the Confirm button to complete the deletion.
7. Folder List Check that files or folders have been deleted from the list.

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

Setting up version control

You can enable versioning on the bucket.

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.

Check version list

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

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.

   Category	Detailed description
   filename	File name
   Modification date	File modification date and time
   Version ID	Version 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
   Etag	Object that identifies files, specific version
   Size	Version file size
   More	Provides 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
   Delete	Delete 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

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.

Delete version file

You can delete a file’s version list.

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.

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

   Category	Detailed description
   Permission	Public 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.

2.5 - Replication Policy Management

Replication can be performed on buckets 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 service through the replica bucket.

Add replication policy

To add a replication policy, follow the steps below.

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.

2. On the Service Home page, click the Object Storage menu. 2. Go 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. 3. Object Storage Details Navigate to the page.

4. Click the Clone tab.

5. Click the Add button. 5. Add Replication Policy The popup window opens.

6. After entering the policy information, click the Confirm button. 6. A popup window notifying the creation of a backup policy opens.

   Category	Required status	Detailed description
   Policy name	Essential	Enter the replication policy name using English letters, numbers, and special characters (-._) within 255 characters
   Clone location	Required	Select the replication location (region) Other locations can be selected
   Replication bucket name	Required	Select the name of the replica bucket If it is the same as the source bucket name or is being used as a replica bucket for another source, adding a replication policy is not allowed
   Target file	Essential	Select files to replicate All: Replicate all files Prefix: Replicate 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(%<>#\`^)
   Priority	Required	When multiple replication policies are set, you can specify the priority cannot be set redundantly with another replication policy that uses the same replication bucket
   Delete marker duplication	Selection	Whether to use delete marker replication

   Table. Add replication policy popup items

7. Click the Confirm button. 7. A replication policy will be added.

Modify replication policy

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

Follow these steps to modify the replication policy.

1. All Services > Storage > Object Storage Click the menu. 1. Navigate to the Service Home page of Object Storage.

2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.

3. On the Object Storage List page, click the resource to edit the replication policy. 3. Object Storage Details Go to the page.

4. Click the Clone tab.

5. Click the More > Edit button for the policy you want to modify in the replication policy list. 5. Edit Replication Policy The popup window opens.

6. After modifying the replication policy information, click the Confirm button. 6. A popup window informing you of the replication policy modification opens.

   Category	Whether required	Detailed description
   Clone location	Required	Select replication location (region) Other locations can be selected
   Replication bucket name	Required	Select the name of the replicated bucket If the source or replica bucket does not have versioning enabled, selection is not allowed If it is the same as the source bucket name or is being used as a replica bucket for another source, selection is not allowed
   Target file	Required	Select files to replicate All: Replicate all files Prefix: Replicate 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(%<>#\`^)
   Priority	Required	Specify priority when multiple replication policies are set Cannot be configured redundantly with another replication policy that uses the same replication bucket
   Delete marker duplication	Selection	Whether to use delete marker replication

   Table. Replication policy edit popup items

7. Click the Confirm button. 7. The replication policy modification is complete.

Change Replication Policy Status

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

To change the replication policy status, follow these steps.

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage list page, click the resource to change the replication policy status. 3. Object Storage Details Navigate to the page.
4. Click the Clone tab.
5. From the replication policy list, click the More > Enable or More > Disable button of the policy whose status you want to change. 5. A popup window opens to notify of a replication policy status change.
   • Enabled: Performs replication according to the replication policy.
   • Disable: Stop performing replication.
6. Click the Confirm button. 6. The status of the replication policy changes.

Delete replication policy

You can delete unused replication policies.

Follow these steps to modify the replication policy.

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage List page, click the resource to delete the replication policy. 3. Object Storage Details Navigate to the page.
4. Click the Copy tab.
5. Click the More > Delete button for the policy you want to edit in the replication policy list. 5. A popup window opens to notify the deletion of the replication policy.
6. Click the Confirm button. 6. The replication policy is being deleted.

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 metrics. For detailed information about ServiceWatch, see the ServiceWatch 개요.

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

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage List page, click the resource to enable ServiceWatch replication metrics. 3. Object Storage Details Navigate to the page.
4. On the Object Storage Details page, click the Replication tab. 4. Go to the Clone tab.
5. Click the Edit button for ServiceWatch replication metrics. 5. ServiceWatch Replication Metric Edit Navigate to the popup window.
6. ServiceWatch Replication Metric Modification In the popup window, after selecting Enable, check the guidance text and click the Confirm button.
7. Check the ServiceWatch replication metric items in the Replication tab.

Disable ServiceWatch replication metrics

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

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage list page, click the resource to disable ServiceWatch detailed monitoring. 3. Navigate to the Object Storage Details page.
4. On the Object Storage Details page, click the Replication tab. 4. Go to the Clone tab.
5. Click the Edit button for the ServiceWatch replication metric. 5. ServiceWatch Replication Metric Edit Navigate to the popup window.
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.

2.6 - Copy original file

Using the original file copy feature, you can copy the original file to the target bucket as is, regardless of replication policy settings.

Add copy operation

To copy the original file in Object Storage, follow these steps.

1. Click the All Services > Storage > Object Storage menu. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. On the Object Storage List page, click the resource to copy the original file. 3. Go to the Object Storage Details page.
4. In the Copy Original File tab, click the Add Task button. 4. Add original file copy task A popup window opens.
5. Add Task In the popup window, set the copy task information, then click the Confirm button.

   Category	Required status	Detailed description
   Task name	Required	Enter the name of the copy job Enter using English letters, numbers, and special characters (-,_) within 255 characters
   Target bucket location	Select the location of the target bucket
   Target bucket name	Select the name of the target bucket

   Table. Copy task items

   Reference

   • The file operates according to the versioning/encryption status of the replica bucket.
   • Delete Marker is excluded from the copy target.
   • Copying between the same bucket is not allowed.

   6. When a popup notifying the copy opens, click the Confirm button. 6. The original file copy operation is added.

Copy operation and view history

On the Object Storage Details page’s Original File Copy tab, you can view and manage the list of original file copy jobs and their information.

To view the list of source file copy jobs and job history, follow these steps.

1. All Services > Storage > Object Storage Click the menu. 1. Navigate to the Service Home page of Object Storage.
2. Service Home 페이지에서 Object Storage 메뉴를 클릭하세요. 2. Go to the Object Storage List page.
3. Object Storage list On the Object Storage list page, click the resource to view the copy job information. 3. Object Storage Details Navigate to the page.
4. Click the Original File Copy tab on the Object Storage Details page.

   Category	Detailed description
   Task name	Copy job name Click to view the status and detailed information of the job
   Target bucket name	Copy target bucket name
   Target bucket location	Destination bucket location (region)
   Start date and time	Copy start date and time
   Completion time	Copy completion time
   status	Task progress status Pending: Task pending In progress: Task in progress Completed: Task completed Cancelled: Task cancelled Failed: Task failed due to an error during execution
   Cancel	Cancel the selected task Pending or In progress tasks can only be canceled
   Add task	New copy task can be added If there is an ongoing copy task, adding a copy task is not allowed

   Table. Object Storage original file copy tab item

Cancel copy operation

To cancel the original file copy operation, follow these steps.

1. All Services > Storage > Object Storage menu, click it. 1. Navigate to the Service Home page of Object Storage.
2. On the Service Home page, click the Object Storage menu. 2. Go to the Object Storage List page.
3. Object Storage List page, click the resource for which you want to cancel the copy operation. 3. Object Storage Details Navigate to the page.
4. Original File Copy tab, click the Cancel Operation button for the copy job you want to cancel.
5. When a popup indicating that the copy operation has been canceled opens, click the Confirm button.
6. Original File Copy tab’s original file copy task list, verify whether the job was canceled.

3 - Release Note

Object Storage