glaciercmd - a simple tool to consume Amazon's Glacier AWS service
glaciercmd is a simple tool to consume Amazon's Glacier AWS service, using the AWS REST API.
There are several modes of operation, all of which can be found in the synopsis below. Each mode has a different set of required and optional arguments, which can also be found in the synopsis. Help mode can be used in a context sensitive manner. For example, -h will show all the modes, and -h LIST will show help about the LIST mode.
All commands require proper authentication. This can be provided on the command line by using -k -s -r or by creating a configuration file and specifying it with -c config-file
glaciercmd is licensed under the GPLv3 license. For more information, see the LICENSE file. This project uses libraries and routines which may have a different license. Refer to the included licenses in the source files and/or JAR files for more information.
Building glaciercmd requires the following:
- Oracle Java or OpenJDK >= 6
- Apache Ant >= 1.8
Then you can simply call
ant dist to create a dist folder with everything glaciercmd needs to run. You can also use
ant package-tar to create a tarball
Alternatively, if using Ubuntu or Debian, you can try using the glaciercmd PPA at: https://launchpad.net/~lordgaav/+archive/glaciercmd
glaciercmd [-c <FILE>] -d | -h <COMMAND> | -i | -j | -l <TYPE> | -m | -n | -o | -u | -v [-k <KEY>] [-r <REGION>] [-s <SECRET>]
glaciercmd -h <COMMAND>
glaciercmd -l <TYPE> --vault <VAULT>
glaciercmd --description <DESC> --input <INPUT> -u --vault <VAULT>
glaciercmd --archive <ARCHIVE> -d --output <OUTPUT> --vault <VAULT>
glaciercmd --archive <ARCHIVE> -m --vault <VAULT>
glaciercmd -i --vault <VAULT>
glaciercmd --job-id <JOBID> -n --output <OUTPUT> --vault <VAULT>
glaciercmd -j --job-id <JOBID> --vault <VAULT>
glaciercmd --archive <ARCHIVE> -o --vault <VAULT>
Use this archive id
-c --config FILE
Use a configuration file
Download file from a vault. Note: this command will block until the file has been downloaded, and will probably take multiple hours.
Use this description
-h --help COMMAND
Show help and examples
Request an inventory from Glacier. This command returns a job id which can be fed to get-inventory.
Use this file as input
Retrieve an inventory from Glacier. If the inventory is not yet available, this method will block until it is.
Use this job id
-k --key KEY
Amazon AWS user key
-l --list TYPE
List Glacier objects (vault|archive)
Request a download from Glacier. This command returns a job id which can be fed to get-download.
Retrieve a download from Glacier. If the download is not yet available, this method will block until it is.
Delete an archive from a vault.
Use this file as output
-r --region REGION
Amazon AWS region
-s --secret SECRET
Amazon AWS user secret
Upload file into a vault
Select this vault
Show version information
All command line parameters can optionally be provided using a configuration file. Exception on this are the mode selectors. The configuration file uses a simple format, which is:
option is the same as the long options which can be specified on the command line. For example, this is a valid configuration line:
Configuration options are parsed in the following order:
- The -c option.
- All options provided on the command line, in the order they are specified.
It is possible to override already specified configuration options by specifying them again. Duplicate options will take the value of the last one specified. An example configuration file can be found in the distribution package.
glaciercmd supports the following AWS Glacier regions:
- VIRGINIA - glacier.us-east-1.amazonaws.com
- OREGON - glacier.us-west-2.amazonaws.com
- CALIFORNIA - glacier.us-west-1.amazonaws.com
- IRELAND - glacier.eu-west-1.amazonaws.com
- TOKYO - glacier.ap-northeast-1.amazonaws.com
No known bugs currently exist.
Nick Douma (firstname.lastname@example.org)