---
name: "Net::Amazon::S3::ACL"
section: "3pm"
platform: "linux"
package: "libnet-amazon-s3-perl"
version: "0.991-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Amazon::S3::ACL"
---

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

Amazon S3 ACL support

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