a S3 Rich Support client - multi config - interactive command line tool - easy to debug with http protocol - AWS4, AWS2 support - support http redirect for multi region of AWS S3
current status:
| function | descrrption | CEPH | AWS | |-----------------------------------------------------------|---------------------------------------------|------|-----| | la | list all objects | O | O | | ls | list bucket | O | O | | ls [bucket] | list objects in the bucket | O | O | | ls s3://[bucket] | list objects in the bucket | O | O | | mb [bucket] | create bucket | O | O | | rb [bucket] | delete bucket | O | O | | put [file] s3://[bucket]/[object] | upload the file sepcific object name | O | 0 | | put [file] s3://[bucket] | upload the file use file name as objec name | O | O | | put test s3://[bucket]/[object] | upload a test file sepcific object name | O | O | | get s3://[bucket]/[object] file | download objec | O | O | | get s3://[bucket]/[object] | download objec in current folder | O | O | | cat s3://[bucket]/[object] | show the object content | O | O | | del s3://[bucket]/[object] | delete the object | O | O | | tag list s3://[bucket]/[object] key1=value1 [key2=value2] | list tag(s) to the object | O | O | | tag ls s3://[bucket]/[object] key1=value1 [key2=value2] | list tag(s) to the object | O | O | | tag add s3://[bucket]/[object] key1=value1 [key2=value2] | add tag(s) to the object | O | O | | tag put s3://[bucket]/[object] key1=value1 [key2=value2] | add tag(s) to the object | O | O | | tag del s3://[bucket]/[object] | remove tag(s) from the object | O | O | | tag rm s3://[bucket]/[object] | remove tag(s) from the object | O | O | | /uri?query | give the orignal url | O | O | |-----------------------------------------------------------|---------------------------------------------|------|-----| | s3_type [ceph/aws/aws4/aws2] | change the api for different S3 providor | | | | log [trace/debug/info/erro] | change the log level | | | | | - trace: more detail about rust | | | | | - debug: for auth signature hash info | | | | | - Info: for Http header and body | | | | logout | logout and reselect user | | | | Ctrl + d | logout and reselect user | | |
| s3 type | auth type | format | virtual-hosted–style path-style | |---------|-----------|--------|---------------------------------| | ceph | aws4 | json | path-style | | aws | aws4 | xml | virtual-hosted–style |
Please download and install Rust and Cargo (Rust package manager) - Install Rust - Install Cargo
Clone the code
git clone https://github.com/yanganto/s3rs.git
cargo build --release./target/release/s3rscargo install s3rs
