The page has been translated by Gen AI.

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.

Notice
  • The replication feature operates in a 1:N structure, allowing replication within a region or between regions. When performing cross-region replication, data transfer fees are added.
  • The replication feature applies only to files uploaded after the replication policy is set.
  • Even if you delete the original version file, files in the replica bucket are not deleted.
    • Example: If set from Bucket A to Bucket B, even if the version file of Bucket A is deleted, it remains in Bucket B.
  • You can set up bidirectional replication.
    • Example: When set as Bucket A ↔ Bucket B, files uploaded to Bucket A are replicated to Bucket B, and files uploaded to Bucket B are replicated to Bucket A.
  • The duplicated file is not duplicated.
    • Example: If set as Bucket A → Bucket B → Bucket C, files replicated from Bucket A → Bucket B are not replicated from Bucket B → Bucket C.
Reference
kr-south region does not provide inter-region Object Storage replication functionality.

Add replication policy

Notice
  • You can set replication on the created bucket.
  • To add a replication policy, you must set the version control feature to enabled.
  • To set up the version management feature, refer to Setting Version Management.

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.
CategoryRequiredDetailed Description
Policy NameRequiredEnter the name of the replication policy
  • Enter within 255 characters, including English letters, numbers, and special characters (-._)
Replication LocationRequiredSelect replication location (region)
  • Other locations can be selected
Replication Bucket NameRequiredSelect the name of the replication bucket
  • If set the same as the source bucket name, adding a replication policy is not allowed
Target FileRequiredSelect 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 constraint)
  • Special characters (%<>#\`^|{}[]) cannot be entered
  • When performing putobject using the S3 API’s prefix option, the prefix must start with /
Delete marker duplicationSelectWhether to use delete marker duplication
Table. Replication Policy Add Popup Items
  1. Confirm button을 클릭하세요. 복제 정책이 추가됩니다.
Caution

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

  • Example: If a deleted policy remains for a replication bucket, you cannot add a replication policy.

​

Edit replication policy

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

Notice
  • To modify the replication policy, you must set the version control feature to enabled.
  • How to set up the version management feature, refer to Set up version management.

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.
CategoryRequiredDetailed description
Replication locationRequiredSelect replication location (region)
  • Other locations can be selected
Replication Bucket NameRequiredEnter the name of the replicated bucket
  • If set the same as the original bucket name, replication policy cannot be modified
  • If you set a bucket already in use as the replication bucket, replication policy cannot be modified
Target FileRequiredSelect 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 constraint)
    • Special characters (%<>#\`^|{}[]) cannot be entered
    • When performing putObject using the S3 API’s prefix option, the prefix must start with /
Delete marker duplicationSelectWhether to use delete marker duplication
Table. Replication Policy Edit Popup Items
  1. Confirm 버튼을 클릭하세요. 복제 정책 수정이 완료됩니다.
Caution

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

  • Example: If a policy remains after the replica bucket has been deleted, you cannot add a replication policy.

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.
Caution
  • If you change the usage of versioning for the source and replica buckets, replication will not be performed correctly.
    • If versioning of the source bucket is set to disabled, replication will not be performed. If set back to enabled, replication will be performed for files uploaded after the setting.
    • If you set versioning of the replica bucket to disabled, replication will be performed but versioning is not possible. If you set it back to enabled, versioning will apply from the point it is set.
  • If you delete the source bucket, the configured replication policy will also be deleted.
  • If you delete the replica bucket, the replication policy set on the source bucket remains.
    • If you recreate a replication bucket with the same bucket name as a deleted replication bucket, replication will be performed to that bucket.
Permission Management