Tool for Amazon S3 & EC2 Instance (S3.exe)




S3.exe is a Windows command line utility for Amazon S3 & EC2 web services that requires no installation is a single .Exe file with no DLLs and requires only .NET 2.0 or Mono, so will works on a plain vanilla windows.

Download Link: 

https://drive.google.com/file/d/0B9AQ1D2DEgAkY2NXbEl0d2pvUW8/view?usp=sharing


Commands:

auth - Gets and saves your Amazon authentication details for future invocations.
get - Gets an object or objects from S3.
help - Displays help about a specified command.
instances - Displays current EC2 instances (coming in version 1.4)
list - Lists keys or buckets.
put - Puts a file, files or an entire directory hierarchy to S3.
snapshot - Starts an EBS snapshot.


Options:

/acl - Sets the ACL of an uploaded file.
/backup - Respects the Windows archive flag.
/big - Splits and rejoins files on the fly.
/sub - Transfers an entire directory hierarchy.
/sync - Uses HTTP HEAD to rapidly determine which files need to be transferred.
/verbose - Displays diagnostic information.
/yes - Bypasses confirmation prompts.
/nogui - Disables non-essential GUI.

S3 LIST usage :

    Lists the keys in the bucket beginning with the keyprefix, if supplied.  A
    trailing asterisk on the keyprefix is ignored.  With no parameters, gets
    the list of buckets.

    /key & /secret allow the Amazon S3 access key and secret key to be passed
    on the command line (even if auth has previously been used).

Example:             s3 list mybucket/pic*

S3 instances :      Lists the current EC2 instances on a per-AMI basis.

Usage :   s3 instances [/key:<key> /secret:<secret>]

S3 snapshot  usage:  Starts an EBS snapshot.  Returns as soon as job begins.

Usage : s3 snapshot <volumeID> [/key:<key> /secret:<secret>

S3 snapshots :  Lists all snapshots.
Example: s3 snapshot /key:key /secret:secretkey


S3 deletesnapshots <snapshotID|volumeID> [/days:<days>]
Deletes the snapshot specified by snapshotID, or all snapshots of the specified EBS volume older than the specified number of days.

S3 PUT usage :
S3 put <bucket>[/<keyprefix>] <path> [/big[:<size>]] [/backup]  [/sync] [/acl:<acl>] [/sub[:withdelete]] [/yes] [/key:<key> /secret:<secret>]

Puts the file(s) specified by the path to S3.  Wildcards are supported. The filename excluding path is suffixed to the end of the supplied key  prefix, if any.

/big splits files into 10MB chunks suffixed with .000, .001 etc.  This is done without creating any temporary files on disk.  A custom chunk size can be specified in MB, e.g. /big:0.1 creates chunks of about 100KB.

/backup causes only files with the archive attribute to be copied, and the archive attribute is reset after copying (Windows only).

/sync only uploads files that do not exist on S3 or have been modified since last being uploaded.  It can be used alone or in conjunction with the
/sub option for a fast incremental backup of a whole directory.

/acl sets the ACL.  To make files public use /acl:public-read

 /sub copies an entire directory hierarchy.  The keyprefix must be absent or end with a slash (/), and the path can be an existing directory. 
/sub:withdelete option does the same but also deletes keys on S3 that start with the given keyprefix (if provided) but don't correspond to a local file.

/yes surpresses prompting on each delete with the /sub:withdelete option.

 /key & /secret allow the Amazon S3 access key and secret key to be passed on the command line (even if auth has previously been used).

 /nogui disables the graphical progress window.

Examples:           s3 put mybucket pic*.jpg /acl:public-read
s3 put mybucket/pictures/ c:\mypictures\ /sub:withdelete /sync



S3 GET USAGE:

s3 get <bucket>/<keyprefix> [<path>] [/big] [/sub] [/key:<key> /secret:<secret>]

Gets the specified object(s) from S3. If no filename is supplied then the  suffix of the key after the final slash is used as the filename, except    with the /sub option (see below).

A trailing * on the end of the key is treated as a wildcard, except when the /big option or a full <filename> is specified.

/big fetches a file or files split using /big with the put command.

/sub causes all keys beginning with the specified keyprefix to be fetched   and forward slashes (/) in the key names used to create directories as  needed.  This enables a whole directory hierarchy uploaded with 'put /sub'  to be downloaded.

/key & /secret allow the Amazon S3 access key and secret key to be passed on the command line (even if auth has previously been used).

/nogui disables the graphical progress window.


Examples:    s3 get mybucket/pic*
                      s3 get mybucket/pictures/ /sub

Comments

Popular posts from this blog

Observium: Configuring Microsoft Windows 2008 Server SNMP Agent

AWS: Introduction to AWS (Amazon Web Services)

System/Server Health Status using PowerShell