s3java is a java edition s3cli
Inspired by awssdk examples
Download prebuilt binary
- gradle(gradle7 or above)
gradle jar
- maven
mvn package
alias s3java="java -jar `pwd`/build/libs/s3java-1.2.jar"
s3java -h
# create Bucket s3java -e http://127.0.0.1:9000 -a root -s ChangeMe create-bucket bucket-name # list(ls) all my Buckets s3java -e http://127.0.0.1:9000 -a root -s ChangeMe ls # head Bucket s3java -e http://127.0.0.1:9000 -a root -s ChangeMe head bucket-name # delete Bucket s3java -e http://127.0.0.1:9000 -a root -s ChangeMe delete bucket-name
- upload(put) Object(s)
# upload file(s) s3java upload bucket-name/k0 --data KKKK # upload a Object(k0) with content KKKK s3java upload bucket-name/k1 /etc/hosts # upload a file and specify Key(k1) s3java --v2sign upload bucket-name/k2 /etc/hosts # upload(V2 sign) a file and specify Key(k2) s3java upload bucket-name /etc/hosts # upload a file and use filename(hosts) as Key s3java upload bucket-name *.txt # upload files and use filename as Key s3java upload bucket-name/dir/ *.txt # upload files and set Prefix(dir/) to all uploaded Object s3java --presign put bucket-name/k3 file # presign(V4) a PUT Object URL s3java --presign --v2sign put bucket-name/k4 file # presign(V2) a PUT Object URL
- download(get) Object(s)
# download Object(s) s3java download bucket-name/k0 # download Object(k0) to current dir s3java --v2sign download bucket-name/k2 # download(V2 sign) Object(k2) to current dir s3java download bucket-name/k1 k2 k3 # download Objects(k1, k2 and k3) to current dir s3java --presign download bucket-name/k1 # presign(V4) a GET Object URL s3java --presign --v2sign download bucket-name/k2 # presign(V2) a GET Object URL
- list(ls) Objects
# list Objects s3java list bucket-name # list s3java list bucket-name/prefix # list Objects with specified prefix s3java list-v2 bucket-name # listObjects v2 s3java list-v2 bucket-name/prefix # listObjects v2 with specified prefix
- delete(rm) Object(s)
# delete Object(s) s3java delete bucket-name/k0 # delete an Object s3java delete bucket-name/k1 k2 k3 # delete Objects s3java --presign delete bucket-name/hosts # presign(V4) an DELETE Object URL s3java --presign --v2sign delete bucket-name/k4 # presign(V2) an DELETE Object URL