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  <https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#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.

perl v5.34.0                                       2022-07-18                          Net::Amazon::S3::ACL(3pm)