The S3 command-line tool is the most reliable way of interacting with Amazon Web Services' Simple Storage Service (AWS S3). This article will guide you through setting it up and using it for common tasks.
- Open a terminal. On Mac OSX, the Terminal application can be found in
Applications/Utilities. Run the following commands:
| Code Block |
|---|
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws |
To verify that the tool is properly installed, run the following command
- Follow the instructions in the AWS documentation under Quick Configuration. This will require you to input the access key ID and secret access key provided to you by DevOps.
Using the tool
List a directory:
| Code Block |
|---|
|
aws s3 ls s3://bucket-name/path/to/file |
...
| Tip |
|---|
| title | Tip: Add the --human-readable flag to the end of your command to get more human-readable sizes |
|---|
|
| Code Block |
|---|
| aws s3 ls s3://bucket-name/path/to/file --human-readable |
| Code Block |
|---|
| PRE dir1/
PRE dir2/
2015-01-01 10:10:10 1.2 KiB File1.zip
2015-01-02 11:11:11 7.3 MiB File2.pdf |
|
| Code Block |
|---|
aws s3 cp s3://bucket-name/path/to/file ~/Downloads |
The file will be saved to your Downloads folder.
| Code Block |
|---|
aws s3 cp ~/Downloads/file1.zip s3://bucket-name/path/to/destination --acl public-read |
...
| Note |
|---|
|
If you don't include –acl public-read, no one will be able to see your file! |
| Code Block |
|---|
aws s3 rm s3://bucket-name/path/to/file |
...
| Info |
|---|
For more documentation, run aws s3 help |
Related articles
| Filter by label (Content by label) |
|---|
| showLabels | false |
|---|
| max | 5 |
|---|
| spaces | EdxOps |
|---|
| showSpace | false |
|---|
| sort | modified |
|---|
| reverse | true |
|---|
| type | page |
|---|
| labels | s3 |
|---|
|
...