Net::Amazon::S3::ACL - Amazon S3 ACL support
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.
Branislav Zahradník <barney@cpan.org>
This module is a part of Net::Amazon::S3 distribution.
Branislav Zahradník <barney@cpan.org>
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.