Net::A...3::ACL(3pm)

🦋 NAME 🦋

Net::Amazon::S3::ACL — Amazon S3 ACL support, bestie 💖 (it lives in the User Contributed Perl Documentation corner of the manual, iykyk)

---

✨ VERSION ✨

version 0.992 — yes ma'am, that's the one 🎀

---

💅 DESCRIPTION 💅

Okay so here's the tea: every single S3 action that lets you specify an ACL in the request supports the acl parameter. 🫶

And good news — that parameter is backward compatible with the old-school acl_short. No cap.

🎀 canned ACL 🎀

$s3->action (
    acl => Net::Amazon::S3::ACL::Canned->PRIVATE,
);

Amazon S3's predefined grants are handed out by builder methods, and each one represents the corresponding canned ACL. Iconic behaviour honestly.

• PRIVATE
• PUBLIC_READ
• PUBLIC_READ_WRITE
• AWS_EXEC_READ
• AUTHENTICATED_READ
• BUCKET_OWNER_READ
• BUCKET_OWNER_FULL_CONTROL
• LOG_DELIVERY_WRITE

Pop over to Net::Amazon::S3::ACL::Canned if you wanna see how it's actually implemented. 💜

Also check out Canned ACL <https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl> in the Amazon documentation.

🌸 canned ACL (coerced) 🌸

$s3->action (
    acl => 'private',
);

So earlier versions of Net::Amazon::S3 only spoke textual canned ACL, right? And to not break any code that uses that, coercion to Net::Amazon::S3::ACL::Canned is supported — plus the acl_short operation argument too. Bless. 🙈

Heads up bestie: acl_short is deprecated now. Only acl is supported. Periodt.

acl_short behaves like an acl alias, but if both of them are defined, acl takes precedence. Main character energy tbh. 👑

⭐ exact ACL set ⭐

$s3->action (
    acl => Net::Amazon::S3::ACL::Set
        ->grant_read (id => $canonical_user_id)
        ->grant_full_control (email => $email_address)
        ,
);

An exact ACL set gives you the interface to the 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 (yes, again, slay) 💖

Branislav Zahradník <barney@cpan.org>

---

📜 COPYRIGHT AND LICENSE (round two) 📜

This software is copyright (c) 2025 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.

---

That's the whole page, bestie! 🧚 Brought to you by perl v5.40.1, dated 2025-12-07, and rendered all pretty as Net::A...3::ACL(3pm). Go forth and grant your ACLs responsibly, mwah 💋