Net::Amazon::S3::Client::Bucket man page on Fedora

Net::Amazon::S3::Client::Bucket man page on Fedora

Man page or keyword search:
man Server 31170 pages
apropos Keyword Search (all sections)
Output format

Net::Amazon::S3::ClienUseruContributed Perl Net::Amazon::S3::Client::Bucket(3)

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' );

perl v5.14.1			  2010-03-30Net::Amazon::S3::Client::Bucket(3)

[top]

List of man pages available for Fedora

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]

Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................

Vote for polarhome