https://github.com/wikiwi/s3-bash4

Bash Commands for S3 using AWS Signature Version 4
https://github.com/wikiwi/s3-bash4

Last synced: 5 days ago
JSON representation

Bash Commands for S3 using AWS Signature Version 4

• Host: GitHub
• URL: https://github.com/wikiwi/s3-bash4
• Owner: wikiwi
• License: apache-2.0
• Created: 2015-07-02T03:53:55.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-08-14T15:19:25.000Z (5 months ago)
• Last Synced: 2024-12-18T22:06:34.827Z (13 days ago)
• Language: Shell
• Size: 25.4 KB
• Stars: 40
• Watchers: 1
• Forks: 27
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# s3-bash4

_s3-bash4_ is a small collection of _Bash_ scripts to do simple interaction with _Amazon S3_ using [_AWS Signature Version 4_](http://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html). The advantage of using _s3-bash4_ is that it's extremly lightweight and easy to use. No need to setup _Python_, _Java_, _Ruby_ and co.

This is inspired by the discontinued [_s3-bash_](https://github.com/cosmin/s3-bash) from _cosmin_. I was in need of a _Bash_ version that supports the newer _AWS Signature Version 4_.

### Usage

    # Get file from bucket:

    s3-get -k {accesskey} -s /{path}/{secretid} -r {region} /{bucketname}/{filename} > {filename}

    # Upload file to bucket:

    s3-put -k {accesskey} -s /{path}/{secretid} -r {region} -T /{path}/{filename} /{bucketname}/{filename}

    # Delete from bucket:

    s3-delete -k {accesskey} -s /{path}/{secretid} -r {region} /{bucketname}/{filename}

### Environment Variables

Variable               | Description

---------------------- | -----------------------------------------------------------

`AWS_ACCESS_KEY_ID`    | Default _AWS Access Key ID_

`AWS_SECRET_ACCESS_KEY`| Default _AWS Secret Access Key_

`AWS_DEFAULT_REGION`   | Default _AWS S3 Region_

`AWS_SECURITY_TOKEN`   | Default _AWS Security Token for temporary credentials_

### Requirements

  - _OpenSSL_

  - _cUrl_

### License

_Apache License Version 2.0_