22s3java is a java edition [ s3cli] ( https://github.com/shvc/s3cli )
33Inspired by [ awssdk] ( https://github.com/awsdocs/aws-doc-sdk-examples ) examples
44
5- #### Download prebuild [ binary] ( https://github.com/shvc/s3java/releases )
5+ #### Download prebuilt [ binary] ( https://github.com/shvc/s3java/releases )
66
77#### Or build fat jar from source
88```
9+ # need gradle7 or above
910git clone https://github.com/shvc/s3java
1011cd s3java
1112gradle jar
@@ -14,61 +15,62 @@ gradle jar
1415## Usage
1516#### Create alias
1617```
17- s3java=' java -jar /path/to /s3java-1.1 .jar'
18+ alias s3java=" java -jar `pwd`/build/libs /s3java-1.2 .jar"
1819s3java -h
1920```
21+
2022#### Bucket
2123``` shell
2224# create Bucket
23- java -jar s3java-1.1.jar -e http://192.168.56.3 :9000 -a root -s ChangeMe create-bucket bucket-name
25+ s3java -e http://127.0.0.1 :9000 -a root -s ChangeMe create-bucket bucket-name
2426
2527# list(ls) all my Buckets
26- java -jar s3java-1.1.jar -e http://192.168.56.3 :9000 -a root -s ChangeMe ls
28+ s3java -e http://127.0.0.1 :9000 -a root -s ChangeMe ls
2729
2830# head Bucket
29- java -jar s3java-1.1.jar -e http://192.168.56.3 :9000 -a root -s ChangeMe head bucket-name
31+ s3java -e http://127.0.0.1 :9000 -a root -s ChangeMe head bucket-name
3032
3133# delete Bucket
32- java -jar s3java-1.1.jar -e http://192.168.56.3 :9000 -a root -s ChangeMe delete bucket-name
34+ s3java -e http://127.0.0.1 :9000 -a root -s ChangeMe delete bucket-name
3335```
3436
3537#### Object
36- - upload(put) Objcet (s)
38+ - upload(put) Object (s)
3739``` shell
3840# upload file(s)
39- java -jar s3java-1.1.jar upload bucket-name/k0 --data KKKK # upload a Object(k0) with content KKKK
40- java -jar s3java-1.1.jar upload bucket-name/k1 /etc/hosts # upload a file and specify Key(k1)
41- java -jar s3java-1.1.jar --v2sign upload bucket-name/k2 /etc/hosts # upload(V2 sign) a file and specify Key(k2)
42- java -jar s3java-1.1.jar upload bucket-name /etc/hosts # upload a file and use filename(hosts) as Key
43- java -jar s3java-1.1.jar upload bucket-name * .txt # upload files and use filename as Key
44- java -jar s3java-1.1.jar upload bucket-name/dir/ * .txt # upload files and set Prefix(dir/) to all uploaded Object
45- java -jar s3java-1.1.jar --presign put bucket-name/k3 file # presign(V4) a PUT Object URL
46- java -jar s3java-1.1.jar --presign --v2sign put bucket-name/k4 file # presign(V2) a PUT Object URL
41+ s3java upload bucket-name/k0 --data KKKK # upload a Object(k0) with content KKKK
42+ s3java upload bucket-name/k1 /etc/hosts # upload a file and specify Key(k1)
43+ s3java --v2sign upload bucket-name/k2 /etc/hosts # upload(V2 sign) a file and specify Key(k2)
44+ s3java upload bucket-name /etc/hosts # upload a file and use filename(hosts) as Key
45+ s3java upload bucket-name * .txt # upload files and use filename as Key
46+ s3java upload bucket-name/dir/ * .txt # upload files and set Prefix(dir/) to all uploaded Object
47+ s3java --presign put bucket-name/k3 file # presign(V4) a PUT Object URL
48+ s3java --presign --v2sign put bucket-name/k4 file # presign(V2) a PUT Object URL
4749```
48- - download(get) Object(s)
50+ - download(get) Object(s)
4951``` shell
5052# download Object(s)
51- java -jar s3java-1.1.jar download bucket-name/k0 # download Object(k0) to current dir
52- java -jar s3java-1.1.jar --v2sign download bucket-name/k2 # download(V2 sign) Object(k2) to current dir
53- java -jar s3java-1.1.jar download bucket-name/k1 k2 k3 # download Objects(k1, k2 and k3) to current dir
54- java -jar s3java-1.1.jar --presign download bucket-name/k1 # presign(V4) a GET Object URL
55- java -jar s3java-1.1.jar --presign --v2sign download bucket-name/k2 # presign(V2) a GET Object URL
53+ s3java download bucket-name/k0 # download Object(k0) to current dir
54+ s3java --v2sign download bucket-name/k2 # download(V2 sign) Object(k2) to current dir
55+ s3java download bucket-name/k1 k2 k3 # download Objects(k1, k2 and k3) to current dir
56+ s3java --presign download bucket-name/k1 # presign(V4) a GET Object URL
57+ s3java --presign --v2sign download bucket-name/k2 # presign(V2) a GET Object URL
5658```
5759
58- - list(ls) Objects
60+ - list(ls) Objects
5961``` shell
6062# list Objects
61- java -jar s3java-1.1.jar list bucket-name # list
62- java -jar s3java-1.1.jar list bucket-name/prefix # list Objects with specified prefix
63- java -jar s3java-1.1.jar list-v2 bucket-name # listObjects v2
64- java -jar s3java-1.1.jar list-v2 bucket-name/prefix # listObjects v2 with specified prefix
63+ s3java list bucket-name # list
64+ s3java list bucket-name/prefix # list Objects with specified prefix
65+ s3java list-v2 bucket-name # listObjects v2
66+ s3java list-v2 bucket-name/prefix # listObjects v2 with specified prefix
6567```
6668
67- - delete(rm) Object(s)
69+ - delete(rm) Object(s)
6870``` shell
6971# delete Object(s)
70- java -jar s3java-1.1.jar delete bucket-name/k0 # delete an Object
71- java -jar s3java-1.1.jar delete bucket-name/k1 k2 k3 # delete Objects
72- java -jar s3java-1.1.jar --presign delete bucket-name/hosts # presign(V4) an DELETE Object URL
73- java -jar s3java-1.1.jar --presign --v2sign delete bucket-name/k4 # presign(V2) an DELETE Object URL
72+ s3java delete bucket-name/k0 # delete an Object
73+ s3java delete bucket-name/k1 k2 k3 # delete Objects
74+ s3java --presign delete bucket-name/hosts # presign(V4) an DELETE Object URL
75+ s3java --presign --v2sign delete bucket-name/k4 # presign(V2) an DELETE Object URL
7476```
0 commit comments