Net::Amazon::S3::ACL(3)

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

VERSION
version 0.99

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) 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.