anycloud bucket

Manage provider object storage through a saved cloud credential.

anycloud bucket create <bucket> --credentials <name> [--region REGION]
anycloud bucket delete <bucket> --credentials <name> [--region REGION]
anycloud bucket exists <bucket> --credentials <name> [--region REGION]
anycloud bucket upload <bucket> <local-file> <remote-key> --credentials <name> [--region REGION]
anycloud bucket download <bucket> <remote-key> <local-file> --credentials <name> [--region REGION]
anycloud bucket rm <bucket> <remote-key> --credentials <name> [--region REGION]

Option	Description
--credentials NAME	Required saved credential
--region REGION	Storage region; required for some providers and cross-region use

create is idempotent if the credential can access an existing Bucket. delete is also idempotent but removes the Bucket and all objects.

exists uses exit codes:

• 0: exists
• 1: does not exist
• 2: check failed

upload accepts one local file, not a directory. Its remote path is the object key. download creates local parent directories. rm removes one object; delete removes the entire Bucket.

anycloud bucket create training-data \
  --credentials production-aws \
  --region us-east-1

anycloud bucket upload training-data \
  ./data.bin datasets/data.bin \
  --credentials production-aws \
  --region us-east-1

anycloud bucket download training-data \
  datasets/data.bin ./downloads/data.bin \
  --credentials production-aws \
  --region us-east-1

For Job mounts and sync guarantees, see Buckets.