view release on metacpan or  search on metacpan

ChangeLog  view on Meta::CPAN

	[0.61 - delete_keys(), refactoring]:
	* s3-perl.pl
	- added ASCII table output, refactored
	* NEWS.md: updated
	* src/main/perl/lib/Amazon/S3.pm.in
	- some perlcritic refactoring
	- pod updates
	(list_bucket): use different markers for v1, v2
	(list_bucket_all)
	- throw $EVAL_ERROR "The server has stopped responding"
	(_make_request): light refactoring
	(_sendrequest): accept keep_root and pass to _xpc_of_content()
	(_xpc_of_content): NoAttr => $TRUE
	(_remember_errors): return false if no error
	* src/main/perl/lib/Amazon/S3/Bucket.pm.in
	- some perlcritic refactoring
	(add_key): check reftype properly
	(set_acl): send conten-length
	* src/main/perl/lib/Amazon/S3/Constants.pm.in
	- additional constants for refactoring

lib/Amazon/S3/Bucket.pm  view on Meta::CPAN

cannot be removed if it contains any keys (contents).

This is an alias for C<$s3-E<gt>delete_bucket($bucket)>.

=head2 get_key $key_name, [$method]

Takes a key and an optional HTTP method and fetches it from
S3. The default HTTP method is GET.

The method returns C<undef> if the key does not exist in the
bucket and throws an exception (dies) on server errors.

On success, the method returns a HASHREF containing:

=over

=item content_type

=item etag

=item value

lib/Amazon/S3/Bucket.pm  view on Meta::CPAN

Optionally provided a callback routine that will be called until you
pass a buffer with a length of 0. Your callback will receive no
arguments but should return a tuple consisting of a B<reference> to a
scalar object that contains the data to write and a scalar that
represents the length of data. Once you return a zero length buffer
the multipart process will be completed.

=item fh

File handle of an open file. The file must be greater than the minimum
chunk size for multipart uploads otherwise the method will throw an
exception.

=item abort_on_error

Indicates whether the multipart upload should be aborted if an error
is encountered. Amazon will charge you for the storage of parts that
have been uploaded unless you abort the upload.

default: true