Getting Started

Retransfer copies a file from one location to another as a one-shot job. The source can be an HTTP/HTTPS URL or an S3 object; the destination must be an S3-compatible bucket. Typical uses include pulling a file from a web server into object storage, or copying objects between S3 buckets or providers.

Prerequisites

An OSC account (sign up here)
An S3-compatible destination bucket. See Service: MinIO if you need object storage on OSC.

Store access credentials as secrets

Create secrets for your S3 destination credentials before creating a Retransfer instance. See the Working with Secrets guide for instructions.

For example, create secrets named accesskeyid and secretaccesskey.

Copy a file

Set your personal access token:

export OSC_ACCESS_TOKEN=<your-personal-access-token>

You find your token under Settings / API in the OSC console.

Download from a web server to S3

npx -y @osaas/cli create eyevinn-docker-retransfer mycopy \
  -o awsAccessKeyId="{{secrets.accesskeyid}}" \
  -o awsSecretAccessKey="{{secrets.secretaccesskey}}" \
  -o s3EndpointUrl="https://myminio.minio-minio.auto.prod.osaas.io" \
  -o cmdLineArgs="https://example.com/video.mp4 s3://mybucket/incoming/video.mp4"

Copy between S3 buckets

To copy from one S3 location to another, supply the S3 source URL as the first argument:

npx -y @osaas/cli create eyevinn-docker-retransfer s3copy \
  -o awsAccessKeyId="{{secrets.accesskeyid}}" \
  -o awsSecretAccessKey="{{secrets.secretaccesskey}}" \
  -o s3EndpointUrl="https://myminio.minio-minio.auto.prod.osaas.io" \
  -o cmdLineArgs="s3://sourcebucket/archive/clip.mp4 s3://destbucket/publish/clip.mp4"

The instance runs the transfer and exits. Check the OSC console or use describe to confirm completion.

CLI argument format

cmdLineArgs="<source> <destination>"

Argument	Supported protocols
Source	`http://`, `https://`, `s3://`
Destination	`s3://` only

The destination path must include the full object key, not just the bucket or prefix.