[![Build Status](https://travis-ci.org/JaSei/Net-AmazonS3-Simple.svg?branch=master)](https://travis-ci.org/JaSei/Net-AmazonS3-Simple)
# NAME

Net::AmazonS3::Simple - simple S3 client support signature v4

# SYNOPSIS

   my $s3 = Net::AmazonS3::Simple->new(
       aws_access_key_id     => 'XXX',
       aws_secret_access_key => 'YYY',
   );

   $s3->get_object($bucket, $key);

   #or for big file is better

   $s3->save_object_to_file($bucket, $key, $file);

# DESCRIPTION

This S3 client have really simple interface and support only get object (yet).

This S3 client use [AWS::Signature4](https://metacpan.org/pod/AWS::Signature4). Signature v4 is [needed](http://stackoverflow.com/questions/26533245/the-authorization-mechanism-you-have-provided-is-not-supported-please-use-aws4) for EU AWS region (for other regions is optionable).
If you need other region, I recommend some other S3 client ([SEE\_ALSO](#see_also)).

# METHODS

## new(%attributes)

### %attributes

#### aws\_access\_key\_id

#### aws\_secret\_access\_key

#### region

default _us-west-1_

#### auto\_region

is is set _wrong_ `region`, is automaticaly changed to _expecting_ region

default _1_

#### validate

object after get is validate (recalculate MD5 checksum)

default _1_

#### secure

is is set, then use _https_ protocol

default _1_

#### host

default _s3.amazonaws.com_

## get\_object($bucket, $key)

`$bucket` - bucket name

`$key` - object key

return [Net::AmazonS3::Simple::Object::Memory](https://metacpan.org/pod/Net::AmazonS3::Simple::Object::Memory)

## save\_object\_to\_file($bucket, $key, $file)

`$bucket` - bucket name

`$key` - object key

`$file` - file to save, optional, default is `tempfile`

return [Net::AmazonS3::Simple::Object::File](https://metacpan.org/pod/Net::AmazonS3::Simple::Object::File)

# SEE\_ALSO

[Paws::S3](https://metacpan.org/pod/Paws::S3) - support version 4 signature too,
[Paws](https://metacpan.org/pod/Paws) support more AWS services,
some dependency of this module don't work on windows

[Net::Amazon::S3](https://metacpan.org/pod/Net::Amazon::S3) - don't support version 4 signature,
some dependency of this module don't work on windows

[AWS::S3](https://metacpan.org/pod/AWS::S3) - don't support version 4 signature,
object is get to memory only (no direct to file - it's not good for downloading big files),
similar interface like [Net::Amazon::S3](https://metacpan.org/pod/Net::Amazon::S3)

[Amazon::S3](https://metacpan.org/pod/Amazon::S3) - don't support version 4 signature,
similar interface like [Net::Amazon::S3](https://metacpan.org/pod/Net::Amazon::S3),
last update Aug 15, 2009

[Amazon::S3::Thin](https://metacpan.org/pod/Amazon::S3::Thin) - don't support version 4 signature,
simple interface

[Furl::S3](https://metacpan.org/pod/Furl::S3) - don't support version 4 signature,
simple interface (similar like [Amazon::S3::Thin](https://metacpan.org/pod/Amazon::S3::Thin)),
last update May 16, 2012

# LICENSE

Copyright (C) Avast Software.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

# AUTHOR

Jan Seidl <[email protected]>