SOAP::Amazon::S3 0.023

SOAP::Amazon::S3 is a Perl module for interfacing with Amazon S3 through SOAP.

SYNOPSIS

An object-oriented interface to handle your Amazon S3 storage. (Still experimental, although functional)

use SOAP::Amazon::S3;

my $s3 = SOAP::Amazon::S3->new( $access_key_id, $secret_access_key, { Debug => 1, RaiseError => 1 } );

my @buckets = $s3->listbuckets;
my $bucket = $s3->createbucket(mybucketname);
my $bucket = $s3->bucket(myoldbucket); # wont create a new bucket

print $bucket->name;
$bucket->delete;

my @objects = $bucket->list;
my $object = $bucket->putobject( $obj_key, $obj_data, { Content-Type => text/plain } );
my $object = $bucket->object( $old_obj_key ); # wont put a new object in the bucket

print $object->name;
$object->delete;
$object->acl(public);
$object->acl(private);
print $object->acl(); # will print public or private

$data = $object->getdata;

FUNCTIONS

SOAP::Amazon::S3->new( $access_key_id, $secret_key_id, { Debug => 0_or_1, RaiseError => 0_or_1 } );

Creates a new S3 requester object. The {} parameters are optional and default to 0. Debug will output all SOAP communications on screen. RaiseError will make your program die if it receives an error reply from Amazon S3, and output the error message on screen. If RaiseError is off, then $s3->{error} will still be set to true when an S3 error occurs.