Linux Certif

Toute la documentation sur la certification Linux LPI

Net::Amazon::S3::Client::Bucket.3pm

NAME

Net::Amazon::S3::Client::Bucket - An easy-to-use Amazon S3 client bucket

SYNOPSIS

   # return the bucket name
   print $bucket->name . "\n";
 
   # return the bucket location constraint
   print "Bucket is in the " . $bucket->location_constraint . "\n";
 
   # return the ACL XML
   my $acl = $bucket->acl;
 
   # list objects in the bucket
   # this returns a L<Data::Stream::Bulk> object which returns a 
   # stream of L<Net::Amazon::S3::Client::Object> objects, as it may
   # have to issue multiple API requests
   my $stream = $bucket->list;
   until ( $stream->is_done ) {
     foreach my $object ( $stream->items ) {
       ...
     }
   }
 
   # or list by a prefix
   my $prefix_stream = $bucket->list( { prefix => 'logs/' } );
 
   # returns a L<Net::Amazon::S3::Client::Object>, which can then
   # be used to get or put
   my $object = $bucket->object( key => 'this is the key' );
 
   # delete the bucket (it must be empty)
   $bucket->delete;
 
 

DESCRIPTION

This module represents buckets.

METHODS

acl

   # return the ACL XML
   my $acl = $bucket->acl;
 
 

delete

   # delete the bucket (it must be empty)
   $bucket->delete;
 
 

list

   # list objects in the bucket
   # this returns a L<Data::Stream::Bulk> object which returns a 
   # stream of L<Net::Amazon::S3::Client::Object> objects, as it may
   # have to issue multiple API requests
   my $stream = $bucket->list;
   until ( $stream->is_done ) {
     foreach my $object ( $stream->items ) {
       ...
     }
   }
 
   # or list by a prefix
   my $prefix_stream = $bucket->list( { prefix => 'logs/' } );
 
 

location_constraint

   # return the bucket location constraint
   print "Bucket is in the " . $bucket->location_constraint . "\n";
 
 

name

   # return the bucket name
   print $bucket->name . "\n";
 
 

object

   # returns a L<Net::Amazon::S3::Client::Object>, which can then
   # be used to get or put
   my $object = $bucket->object( key => 'this is the key' );