CLI reference / storage / copy

stado storage copy

Invocation

stado storage copy [OPTIONS] --from <FROM> --to <TO>

Purpose

Copy queue state from one storage backend to another

Required inputs and options

Input or optionContract
--from <FROM>Source backend
--to <TO>Destination backend
--from-bucket <FROM_BUCKET>Source bucket (gcs, s3) [default: ""]
--to-bucket <TO_BUCKET>Destination bucket (gcs, s3) [default: ""]
--from-account <FROM_ACCOUNT>Source storage account (azure) [default: ""]
--to-account <TO_ACCOUNT>Destination storage account (azure) [default: ""]
--from-container <FROM_CONTAINER>Source container (azure) [default: ""]
--to-container <TO_CONTAINER>Destination container (azure) [default: ""]
--from-path <FROM_PATH>Source root directory (local) [default: ""]
--to-path <TO_PATH>Destination root directory (local) [default: ""]
--from-region <FROM_REGION>Source region (s3); empty defers to the AWS default chain [default: ""]
--to-region <TO_REGION>Destination region (s3); empty defers to the AWS default chain [default: ""]
--prefix <PREFIX>Restrict the copy to this prefix. Repeatable. Omit to copy the whole canonical prefix set
--dry-runPrint the per-prefix plan and copy nothing
--concurrency <CONCURRENCY>Objects copied in parallel [default: 10]

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.