Object Storage

• 1:
• 1.1: Amazon S3 Utilization Guide
• 1.2: Monitoring Metrics
• 2: How-to guides
• 2.1: Access Control
• 2.2: File and Folder Management
• 2.3: Permission Management
• 2.4: Replication Policy Management
• 2.5:
• 3: Release Note

1 -

1.1 - Amazon S3 Utilization Guide

Object Storage provides functions such as service creation, list retrieval, folder list retrieval, folder creation, file upload, download, etc., through the Samsung Cloud Platform Console. Additionally, these functions are also provided via an API compatible with Amazon S3. Therefore, tools that use Amazon S3 can be used in the same way.
To use Amazon S3’s utility, you need to create and verify an authentication key. For details, see Create Authentication Key.

Amazon S3 API

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

Amazon S3 CLI

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

Amazon S3 SDK for Java

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

1.2 - Monitoring Metrics

Object Storage Monitoring Metrics

The following table shows the monitoring metrics of Object Storage that can be checked through Cloud Monitoring. For detailed usage of Cloud Monitoring, please refer to the Cloud Monitoring guide.

2 - How-to guides

The user can enter the required information for Object Storage through the Samsung Cloud Platform Console, select detailed options, and create the service.

Creating an access key

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

Authentication key creation can be done from My Menu > My Info. > Authentication Key Management > Create Authentication Key. For more details, see IAM > Create Authentication Key.

Object Storage Create

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

To create Object Storage, follow the steps below.

1. All Services > Storage > Object Storage Click the menu. Go to the Service Home page of Object Storage.
2. Service Home on the page click the Create Object Storage button. Navigate to the Create Object Storage page.
3. Object Storage creation Enter the information required to create the service on the page.

   Category	Required	Detailed description
   Bucket Name	Required	Bucket name created by the user Starts with a lowercase English letter or digit, and using lowercase English letters, digits, hyphen-, period., input 3~63 characters Period. cannot appear consecutively two or more times. Period. and hyphen- cannot be adjacent. Cannot end with a period. or hyphen-. IP format not allowed admin name not allowed For detailed description of bucket names, refer to Bucket Name Creation Rules.

   Table. Object Storage Required Information Input Items

4. Summary Check the detailed information and estimated billing amount generated in the panel, and click the Complete button.
   • When creation is complete, check the created resources on the Object Storage List page.

Object Storage Check Detailed Information

Object Storage service can view and edit the full resource list and detailed information.
Object Storage Details page consists of Details, Folder List, Tag tabs.

To view detailed information of the Object Storage service, follow the steps below.

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

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

     Table. Status Information and Additional Functions

Detailed Information

Object Storage list page, you can view the detailed information of the selected resource and, if necessary, edit the information.

Folder List

Through the folder list tab, you can view the list of folders and files stored in the bucket.

Replication

Object Storage list You can view and manage the replication information of the selected resource on the page.

Tag

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

Work History

Object Storage Encryption Setup

You can set it to encrypt the data stored in the bucket. After setting bucket encryption, the encryption setting is applied to uploaded data. When using encryption, the SSE‑S3 encryption key method and the AES256 encryption algorithm are applied.

Object Storage Follow the steps below to use bucket encryption.

1. All Services > Storage > Object Storage Click the menu. Go to the Service Home page of Object Storage.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage List page.
3. Object Storage List page, click the resource (bucket) to use encryption. Object Storage Details page will be opened.
4. On the Object Storage Detailed page, check if encryption is not used.
5. If Encryption is Not Used, click the Edit button.Encryption Edit Popup opens.
6. After checking Encryption Use, click the Confirm button.

Object Storage Cancel

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

If you want to cancel Object Storage, follow the steps below.

1. All Services > Storage > Object Storage Click the menu. Go to the Service Home page of Object Storage.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage list page.
3. Object Storage list on the page, select the resource (bucket) to cancel, and click the Cancel Service button.
4. Please enter bucket name to confirm termination.
5. If you have entered the Bucket Name correctly, the Confirm button will be activated. Click the Confirm button.
6. When termination is complete, check whether the resource has been terminated on the Object Storage List page.

2.1 - Access Control

If you set bucket access control to enabled, only resources that are allowed access can access the bucket. You can set it to allow access by entering a public IP or for resources created in the Samsung Cloud Platform Console.

Set up access control

You can set bucket access control to enabled.

Object Storage Follow the steps below to set up access control.

1. All Services > Storage > Object Storage Click the menu. Go to the Service Home page.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage list page.
3. Click the resource (bucket) to set access control on the Object Storage List page. It navigates to the Object Storage Details page.
4. Verify that Access Control is Unused on the Object Storage Details page.
5. Click the Edit button if Access Control is Unused. The Edit Access Control popup opens.
6. After checking Access Control Use, click the Confirm button. On the Object Storage Details page, Access Control will be changed to Use.

7. Public IP, Register service resources to allow access, or set whether to use access control for the Cloud Functions service.

Allow Public IP Access

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

Object Storage in to add Public IP access permission, follow the steps below.

1. All Services > Storage > Object Storage Click the menu. Service Home page will be navigated to.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage list page.
3. Object Storage List page, click the resource (bucket) to set access control. Navigate to the Object Storage Details page.
4. Object Storage Details page, check if access control is enabled.
   • If Access control is unused, click the Edit button, then in the Access control popup change access control to Enabled.
   • Only when access control is enabled, the Allow IP Access, Allow Service Resources, Allow Cloud Functions Service list is displayed.
5. Public IP Allow in Edit click the button. Public IP Allow Edit The popup window opens.
6. Enter the Public IP to allow access, and click the Add button.

   Column	Required	Detailed description
   Public IP Allowed	Required	Enter as a single IP or CIDR format (up to 150 entries) 192.168.x.x (IP format) 192.168.x.x/24 (CIDR format)

   Table. Public IP Allowance Edit Popup Input Items
7. Check the items added to the list and press the Confirm button.
8. Check the added Public IP in the Object Storage Details page’s Access Control > Allow Public IP list.

Allow access to service resources

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

Object Storage Follow the steps below to allow access to service resources.

1. Click the All Services > Storage > Object Storage menu. Go to the Service Home page.
2. Service Home page, click the Object Storage menu. Navigate to the Object Storage list page.
3. Object Storage List page, click the resource (bucket) to set access control. Object Storage Details page navigate.
4. Object Storage Details on the page, check whether Access Control is enabled.
   • Access control is unused, click the Edit button, then in the Access control popup change access control to Enabled.
   • Only when access control is enabled, the IP access allowed, service resource allowed, Cloud Functions service allowed list is displayed.
5. Click the Edit button in Allow Service Resources. The Select Service Resources popup opens.

6. Select the server to allow access, and press the Confirm button.
7. Check the added server in the Object Storage Details page’s Access Control > Service Resource Allow list.

Cloud Functions Allow Service Access

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. Service Home page will be displayed.
2. Click the Object Storage menu on the Service Home page. You will be taken to the Object Storage list page.
3. Object Storage List On the page, click the resource (bucket) to set access control. Object Storage Details Navigate to the page.
4. Object Storage Details page, check if access control is enabled.
   • If Access Control is Disabled, click the Edit button, then in the Access Control popup change Access Control to Enabled.
   • Only when access control is enabled, the list of Allow IP Access, Allow Service Resources, Allow Cloud Functions Service is displayed.
5. Click the Edit button in Cloud Functions Service Allow. The Cloud Functions Service Edit popup opens.
6. After checking Allow, click the Confirm button.

2.2 - File and Folder Management

If you need to manage, such as saving files to the created Object Storage or downloading saved 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.

Object Storage Follow the steps below to create a new folder.

1. All Services > Storage > Object Storage Click the menu. Service Home page will be displayed.
2. Click the Object Storage menu on the Service Home page. It navigates to the Object Storage list page.
3. Object Storage List page, click the resource (bucket) to create a new folder. You will be taken to the Object Storage Details page.
4. Folder List Click the tab. Folder List Navigate to the page.
5. Click the New Folder button. New Folder popup window opens.
6. Enter the folder name to use, and click the Confirm button. A popup window notifying the creation of a new folder will open.

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

File Upload

You can upload a new file or a file you are working on to the bucket. Object Storage Follow the steps below to upload files.

1. Click All Services > Storage > Object Storage menu. Go to the Service Home page.
2. Click the Object Storage menu on the Service Home page. You will be taken to the Object Storage list page.
3. Object Storage List On the page, click the resource (bucket) to upload files. Object Storage Details Navigate to the page.
4. Click the Folder List tab. You will be taken to the Folder List page.
5. File Upload Click the button. File Upload The popup window opens.
6. After clicking the File Attachment button, select the file to upload or drag the file to attach into the popup window.

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

File Download

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

1. Click the All Services > Storage > Object Storage menu. You will be taken to the Service Home page.
2. Click the Object Storage menu on the Service Home page. Go to the Object Storage list page.
3. Object Storage List page, click the resource (bucket) to download. Object Storage Details page will be opened.
4. Click the Folder List tab. You will be taken to the Folder List page.
5. Click the More > Download button located at the far right end of the file to be downloaded. The file download will start.
6. Check that the file download has completed in the browser.

View file information

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

1. All Services > Storage > Object Storage Click the menu. Service Home page will be opened.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage List page.
3. Object Storage list page, click the resource (bucket) that contains the file you want to view file information. Object Storage detail page will be opened.
4. Folder List Click the tab. Folder List Navigate to the page.
5. Click the More > File Info button located at the far right of the file to view information. File Info popup window opens.
6. File Information Check detailed file information in the popup window.

   Category	Detailed description
   file name	file name
   Content type	Object type
   Total size	File size
   Modification Date/Time	The date and time the file was most recently modified
   Permission	Public Access allowance
   URL	Provide Public and Private addresses to access the file path URL Public: Provided to be accessible from external internet network Private: Provides an address accessible from resources created in the same Account and same region of the Samsung Cloud Platform Console

   Table. File Information Items

Copy file

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

1. Click the Storage > Object Storage menu. Go to the Object Storage list page.
2. Object Storage List On the page, click the resource (bucket) to copy the file. Object Storage Details Navigate to the page.
3. Folder List Click the tab. Folder List Navigate to the page.
4. Click the More > File Copy button at the far right of the file to be copied. The File Copy popup window opens.
5. After entering the filename, click the Confirm button. A popup notifying file copy will open.

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 Click the menu. Service Home page will be opened.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage list page.
3. Click the resource (bucket) that contains the file or folder to delete on the Object Storage list page. It moves to the Object Storage details page.
4. Folder List tab, click it. Folder List page, navigate.
5. Click the More > Delete button located at the far right of the file or folder to be deleted. The Delete popup window will open.
   • After selecting multiple files or folders from the left check box, you can click the Delete button at the top to delete multiple files or folders at once.
6. Click the Confirm button in the delete popup to complete the deletion.
7. Folder List Check that files or folders have been deleted from the list.

2.3 - 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 disclosure and download only to users who know the Access Key and Secret Key, but Public permission allows file disclosure and download to anyone worldwide when accessing the file’s Public URL, so caution is required.

Check permission management

You can check the permission settings on the file.

Object Storage Follow the steps below to check file permissions.

1. All Services > Storage > Object Storage Click the menu. Service Home Navigate to the page.
2. Service Home on the page, click the Object Storage menu. Go 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. Object Storage details page will be opened.
4. Folder List Click the tab. Folder List Navigate to the page.
5. Click the More > File Info button located at the far right of the file you want to view file information. The File Info popup window opens.
6. File Information in the popup window Permissions please check.

   Category	Detailed description
   Permission	Public Access allowed or Public Access not allowed

   Table. Permission Information Description

Public Access Allow

You can set the file’s Public Access permission to allow. Object Storage Follow the steps below to set file permissions to allow Public Access.

1. All Services > Storage > Object Storage Click the menu. Service Home Navigate to the page.
2. Service Home on the page, click the Object Storage menu. Go to the Object Storage list page.
3. On the Object Storage List page, click the resource (bucket) that has files to allow Public Access. You will be taken to the Object Storage Details page.
4. Folder List Click the tab. Folder List Navigate to the 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 opens.
6. Check that Permission is in Public Access not allowed state, and 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 In the popup, check Allow Public Access for Permission Management, and click the Confirm button. Navigate to the Folder List page.
9. Click the More > File Info button located at the far right of the file. The File Info popup window opens.
10. Permission is Public Access allowed. Check the state.

2.4 - Replication Policy Management

You can perform replication to a bucket in a different location or the same location.
You can set multiple replication policies, and if the original bucket is unavailable due to a failure or disaster, you can provide service through the replica bucket.

Add replication policy

To add a replication policy, follow these steps.

1. All Services > Storage > Object Storage Click the menu. Navigate to Object Storage’s Service Home page.
2. Click the Object Storage menu on the Service Home page. You will be taken to the Object Storage list page.
3. Object Storage List page, click the resource to add a replication policy. It will navigate to the Object Storage Details page.
4. Click the Duplicate tab.
5. Click the Add button. Add replication policy popup opens.
6. After entering the policy information, click the Confirm button. A popup window notifying the creation of the replication policy opens.

7. Confirm button을 클릭하세요. 복제 정책이 추가됩니다.

​

Edit replication policy

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

To modify the replication policy, follow the steps below.

1. All Services > Storage > Object Storage Click the menu. Navigate to the Service Home page of Object Storage.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage list page.
3. Object Storage List page, click the resource to modify the replication policy. Navigate to the Object Storage Detail page.
4. Clone tab을 클릭하세요.
5. Click the More > Edit button of the policy you want to modify in the replication policy list. Edit Replication Policy popup window opens.
6. After modifying the replication policy information, click the Confirm button. A popup window notifying the replication policy modification will open.

7. Confirm 버튼을 클릭하세요. 복제 정책 수정이 완료됩니다.

Change replication policy status

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

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

1. All Services > Storage > Object Storage Click the menu. Navigate to the Service Home page of Object Storage.
2. Click the Object Storage menu on the Service Home page. Navigate to the Object Storage List page.
3. Click the resource to change the replication policy status on the Object Storage List page. Navigate to the Object Storage Details page.
4. Clone tab click.
5. In the replication policy list, click the More > Activate or More > Deactivate button for the policy whose status you want to change. A popup window notifying the replication policy status change will open.
   • Activation: Performs replication according to the replication policy.
   • Disable: Stops performing replication.
6. Click the Confirm button. The status of the replication policy will change.

Delete replication policy

You can delete unused replication policies.

To modify the replication policy, follow the steps below.

1. All Services > Storage > Object Storage Click the menu. Navigate to Object Storage’s Service Home page.
2. Click the Object Storage menu on the Service Home page. It moves to the Object Storage List page.
3. Object Storage List On the page, click the resource to delete the replication policy. Object Storage Details Navigate to the page.
4. Clone 탭을 클릭하세요.
5. Click the More > Delete button of the policy you want to edit in the replication policy list. A popup notifying the deletion of the replication policy will open.
6. Confirm Click the button. The replication policy will be deleted.

2.5 -

3 - Release Note

Object Storage