Help Center/ Object Storage Service/ Tools Guide/ obsutil/ Bucket Commands/ Configuring a Back-to-Source by Mirroring Rule
Updated on 2026-09-20 GMT+08:00
View PDF
Share

Configuring a Back-to-Source by Mirroring Rule

Function

You can use this command to configure a back-to-source by mirroring rule for a bucket.

Command Line Structure

  • Windows 
    obsutil mirror-back-to-source obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS or Linux 
    ./obsutil mirror-back-to-source obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

  • In Windows, run obsutil mirror-back-to-source obs://test-bucket -method=put -localfile=d:\temp\mirror.json to configure a back-to-source by mirroring rule for bucket test-bucket using the mirror.json file. 
    obsutil mirror-back-to-source obs://test-bucket -method=put -localfile=d:\temp\mirror.json

Start at 2024-09-30 07:59:28.8675681 +0000 UTC

Put mirrorBackToSource rule succeed for bucket [test-bucket], requestId is [000001997666389E4016EA797FAC6033]

Parameter Description

Parameter

Optional or Mandatory

Description

bucket

Mandatory

The bucket name

method

Mandatory

The method. Set it to put when you configure a back-to-source by mirroring rule for a bucket.

localfile

Mandatory

The configuration file for the back-to-source by mirroring rule

config

Optional (additional parameter)

The user-defined configuration file for executing the current command. For details about parameters that can be configured, see Configuration Parameters.

e

Optional (additional parameter)

The endpoint

i

Optional (additional parameter)

The user's AK

k

Optional (additional parameter)

The user's SK

t

Optional (additional parameter)

The user's security token

Helpful Links

Parent topic: Bucket Commands