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. Signature v4 is needed for EU AWS region (for other regions is optionable). If you need other region, I recommend some other S3 client (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

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

SEE_ALSO

Paws::S3 - support version 4 signature too, Paws support more AWS services, some dependency of this module don't work on windows

Net::Amazon::S3 - don't support version 4 signature, some dependency of this module don't work on windows

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

Amazon::S3 - don't support version 4 signature, similar interface like Net::Amazon::S3, last update Aug 15, 2009

Amazon::S3::Thin - don't support version 4 signature, simple interface

Furl::S3 - don't support version 4 signature, simple interface (similar like 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 <seidl@avast.com>

cpanm Net::AmazonS3::Simple

perl -MCPAN -e shell
install Net::AmazonS3::Simple