NAME

Net::Amazon::S3::ACL - Amazon S3 ACL support

VERSION

version 0.991

DESCRIPTION

Every S3 action supporting ACL specification in request supports acl parameter.

Parameter is backward compatible with former acl_short.

canned ACL

$s3->action (
	acl => Net::Amazon::S3::ACL::Canned->PRIVATE,
);

Amazon S3 predefined grants are provided by builder methods, each representing corresponding canned ACL.

PRIVATE

PUBLIC_READ

PUBLIC_READ_WRITE

AWS_EXEC_READ

AUTHENTICATED_READ

BUCKET_OWNER_READ

BUCKET_OWNER_FULL_CONTROL

LOG_DELIVERY_WRITE

See Net::Amazon::S3::ACL::Canned for implementation details.

See Canned ACL in Amazon documentation.

canned ACL (coerced)

$s3->action (
	acl => 'private',
);

Earlier versions of Net::Amazon::S3 supported only textual canned ACL. To not break code that use it coercion to Net::Amazon::S3::ACL::Canned is supported as well as acl_short operation argument.

acl_short is deprecated now, only acl is supported.

acl_short behaves like an acl alias. In case when both are defined, acl takes precedence.

exact ACL set

$s3->action (
	acl => Net::Amazon::S3::ACL::Set
		->grant_read (id => $canonical_user_id)
		->grant_full_control (email => $email_address)
		,
);

Exact ACL set provides interface to x-amz-grant-* header fields.

See Net::Amazon::S3::ACL::Set for implementation details.

AUTHOR

Branislav Zahradník <barney@cpan.org>

COPYRIGHT AND LICENSE

This module is a part of Net::Amazon::S3 distribution.

AUTHOR

Branislav Zahradník <barney@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by Amazon Digital Services, Leon Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav Zahradník.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.