1Net::Amazon::S3::ACL(3)User Contributed Perl DocumentatioNnet::Amazon::S3::ACL(3)
2
3
4

NAME

6       Net::Amazon::S3::ACL - Amazon S3 ACL support
7

VERSION

9       version 0.991
10

DESCRIPTION

12       Every S3 action supporting ACL specification in request supports "acl"
13       parameter.
14
15       Parameter is backward compatible with former "acl_short".
16
17       canned ACL
18                   $s3->action (
19                           acl => Net::Amazon::S3::ACL::Canned->PRIVATE,
20                   );
21
22           Amazon S3 predefined grants are provided by builder methods, each
23           representing corresponding canned ACL.
24
25           PRIVATE
26           PUBLIC_READ
27           PUBLIC_READ_WRITE
28           AWS_EXEC_READ
29           AUTHENTICATED_READ
30           BUCKET_OWNER_READ
31           BUCKET_OWNER_FULL_CONTROL
32           LOG_DELIVERY_WRITE
33
34           See Net::Amazon::S3::ACL::Canned for implementation details.
35
36           See Canned ACL
37           <https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-
38           overview.html#canned-acl> in Amazon documentation.
39
40       canned ACL (coerced)
41                   $s3->action (
42                           acl => 'private',
43                   );
44
45           Earlier versions of Net::Amazon::S3 supported only textual canned
46           ACL.  To not break code that use it coercion to
47           Net::Amazon::S3::ACL::Canned is supported as well as "acl_short"
48           operation argument.
49
50           "acl_short" is deprecated now, only "acl" is supported.
51
52           "acl_short" behaves like an "acl" alias. In case when both are
53           defined, "acl" takes precedence.
54
55       exact ACL set
56                   $s3->action (
57                           acl => Net::Amazon::S3::ACL::Set
58                                   ->grant_read (id => $canonical_user_id)
59                                   ->grant_full_control (email => $email_address)
60                                   ,
61                   );
62
63           Exact ACL set provides interface to "x-amz-grant-*" header fields.
64
65           See Net::Amazon::S3::ACL::Set for implementation details.
66

AUTHOR

68       Branislav Zahradník <barney@cpan.org>
69

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

AUTHOR

74       Branislav Zahradník <barney@cpan.org>
75

77       This software is copyright (c) 2022 by Amazon Digital Services, Leon
78       Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav
79       Zahradník.
80
81       This is free software; you can redistribute it and/or modify it under
82       the same terms as the Perl 5 programming language system itself.
83
84
85
86perl v5.38.0                      2023-07-21           Net::Amazon::S3::ACL(3)
Impressum