The page has been translated by Gen AI.

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.

Caution

When using the Amazon S3 utility, you must use the following version. If you use a different version, some features may be limited, so be careful.

  • SDK v2: 2.22.x or lower
  • SDK v1: 1.12.781 or less
  • CLI v2: 2.22.x or lower
  • CLI v1: 1.36.x or lower
  • SDK for JavaScript v3 : 3.728.0 or lower
  • SDK for Python(Boto3) : 1.35.x or lower

Amazon S3 API

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

Reference
For detailed information about the Amazon S3 API, please refer to Amazon S3 API Guide.
CategoryDetailed description
head-bucketBucket Information Lookup
list-bucketsList bucket
get-bucket-versioningBucket versioning query
put-bucket-versioningModify bucket versioning
get-bucket-encryptionBucket encryption settings query
put-bucket-encryptionApply bucket encryption settings
delete-bucket-encryptionDelete bucket encryption setting
copy-objectObject copy, move, rename
put-objectCreate object
get-objectObject download
list-objectsObject list query
head-objectObject detailed view
get-object-aclObject ACL query
delete-objectDelete Object
  • If versioning is enabled, deleting a file adds a Delete Marker to the file and the Delete Marker becomes the latest version
  • If permanent deletion of a file is required, delete by specifying the version ID
list-object-versionsObject version list query
delete-objectDelete object version
presignPUT object Presigned URL issuance
get-bucket-aclBucket public permission check
create-bucketCreate bucket
delete-bucketDelete bucket
get-bucket-corsBucket CORS (Cross OriginResources) configuration check
put-bucket-corsCreate bucket CORS (PUT)
delete-bucket-corsBucket CORS Delete
put-bucket-taggingBucket tagging creation
get-bucket-taggingBucket tagging query
delete-bucket-taggingDelete bucket tagging
put-bucket-websiteCreate bucket website
get-bucket-websitebucket website view
delete-bucket-websiteDelete bucket website
get-bucket-policy-statusBucket policy status query
put-bucket-aclCreate bucket ACL
create-multipart-uploadMultipart upload creation
upload-partMultipart upload execution
complete-multipart-uploadMultipart upload completed
list-multipart-uploadsMultipart upload list
abort-multipart-uploadDelete incomplete multipart upload
put-object-taggingObject tagging creation
get-object-taggingObject tagging query
delete-object-taggingObject tagging Delete
list-objects-V2Object query (v2)
put-object-aclObject acl creation
list-partsParts lookup
put-public-access-blockPublic access block creation
get-public-access-blockpublic access block lookup
delete-public-access-blockpublic access block delete
put-bucket-lifecycleCreate bucket lifecycle (only Expiration rule can be used)
get-bucket-lifecycleBucket Lifecycle Query
delete-bucket-lifecycleBucket Lifecycle Delete
put-bucket-replicationModify bucket replication policy
  • When using replication-configuration, the following items need to be checked
    • Role: IAM SRN input required
    • Rules > Destination’s Bucket: Bucket SRN input required
    • If Rule ID is not entered, it is automatically generated with a random value
    • Rule Priority is not applied, so any entered value has no effect (can set all to 1)
    • When changing Rule ID, a new policy is created (the existing policy is deleted)
get-bucket-replicationGet bucket replication policy
delete-bucket-replicationDelete bucket replication policy
Table. List of Amazon S3 supported APIs

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.

Note
For SDK guides and Rest API guides for other languages, please check the AWS official website.
Note
  • For using the Amazon S3 SDK, refer to the required region parameter below.
    • Korea West (kr-west1) case: kr-west
    • Korea South 1,2,3(kr-south1,2,3) case: kr-south
  • region parameter is for reference only, and the actual region is distinguished based on the URL.
Note
  • South Korea South 3 (kr-south3) region constraints
    • Samsung Cloud Platform Console through file upload and download functionality is limited.
    • Use of S3 API/CLI via Public URL is restricted.
    • However, access to Private URLs through resources (such as Virtual Server) created in the Samsung Cloud Platform Console is possible.
  • South Korea South1 (kr-south1), South Korea South2 (kr-south2) region constraints
Monitoring Metrics