Net::Amazon::S3::ACL - Amazon S3 ACL support
version 0.99
Every S3 action supporting ACL specification in request supports acl parameter.
acl
Parameter is backward compatible with former acl_short.
acl_short
$s3->action ( acl => Net::Amazon::S3::ACL::Canned->PRIVATE, );
Amazon S3 predefined grants are provided by builder methods, each representing corresponding canned ACL.
See Net::Amazon::S3::ACL::Canned for implementation details.
See Canned ACL in Amazon documentation.
$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.
$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.
x-amz-grant-*
See Net::Amazon::S3::ACL::Set for implementation details.
Branislav Zahradník <barney@cpan.org>
This module is a part of Net::Amazon::S3 distribution.
This software is copyright (c) 2021 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.
To install Net::Amazon::S3, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Amazon::S3
CPAN shell
perl -MCPAN -e shell install Net::Amazon::S3
For more information on module installation, please visit the detailed CPAN module installation guide.