Net::A...CL::Set(3pm)

💖 Net::A...CL::Set — the manual, but make it cute 💖

okay bestie, gather round, because this is Net::A...CL::Set(3pm) from the Perl manual pages and she is lowkey iconic ✨

This one's a Net::Amazon::S3 module — a Representation of explicit ACL, no cap. If you've ever needed to tell S3 exactly who gets to do what, this is the little class that holds all of that. She's giving permissions manager energy and honestly? obsessed. 🎀

---

🌸 VERSION 🌸

version 0.992

(yeah, she's on 0.992, we love an evolving queen 💅)

---

✨ SYNOPSIS ✨

    use Net::Amazon::S3::ACL;

    $acl = Net::Amazon::S3::ACL->new
        ->grant_full_control (
            id => 11112222333,
            id => 444455556666,
            uri => 'predefined group uri',
            email => 'email-address',
        )
        ->grant_write (
            ...
        )
        ;

see how she chains?? method after method after method, straight through 😭 that's the vibe. grant_full_control, then grant_write, then whatever else your heart desires. it's giving fluent interface main character energy fr fr.

---

🦋 DESCRIPTION 🦋

Class representing explicit Amazon S3 ACL configuration.

that's it, that's the whole description bestie. a class. representing explicit Amazon S3 ACL configuration. she's focused, she's minimal, she knows exactly what she is 🫶

---

👑 METHODS 👑

💜 new

Creates new instance.

brand new baby ACL object, fresh out the box ✨

💜 grant_full_control (@grantees)

💜 grant_read (@grantees)

💜 grant_read_acp (@grantees)

💜 grant_write (@grantees)

💜 grant_write_acp (@grantees)

okay so these five are the whole squad — grant_full_control, grant_read, grant_read_acp, grant_write, and grant_write_acp — and every single one of them takes @grantees. what's a grantee, you ask? literally the next section. keep scrolling bestie 👇

---

🌈 GRANTEES 🌈

See also "Who Is a Grantee?" <https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#specifying-grantee> in Amazon S3 documentation.

(the AWS docs said it first, we're just citing our sources 💅)

Each grant_* method accepts list of grantees either in key-value format or as an instance of Net::Amazon::S3::ACL::Grantee::*.

so bestie you got options: you can hand her plain key-value pairs, OR you can hand her a whole Net::Amazon::S3::ACL::Grantee::* object. both valid, both slay. here's how each flavor looks:

• canonical user ID

    ->grant_read (
        id => 123,
        Net::Amazon::S3::ACL::Grantee::User->new (123),
    )

key-value or object, pick your fighter 🫶

• predefined group uri

    ->grant_read (
        uri => 'http://...',
        Net::Amazon::S3::ACL::Grantee::Group->new ('http://...'),
        Net::Amazon::S3::ACL::Grantee::Group->ALL_USERS,
    )

yes she also has Net::Amazon::S3::ACL::Grantee::Group->ALL_USERS sitting right there like a little shortcut icon ⭐

• email address

    ->grant_read (
        email => 'foo@bar.baz',
        Net::Amazon::S3::ACL::Grantee::Email->new ('foo@bar.baz'),
    );

foo@bar.baz my beloved 💌

---

🎀 AUTHOR 🎀

Branislav Zahradník <barney@cpan.org>

---

💖 COPYRIGHT AND LICENSE 💖

This module is part of Net::Amazon::S3.

---

🎀 AUTHOR (yes, again) 🎀

Branislav Zahradník <barney@cpan.org>

(she said it twice, and honestly? she's right to 😌)

---

💖 COPYRIGHT AND LICENSE (yes, again) 💖

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.

free software, same terms as Perl 5 itself — that's the legal tea and it's actually good news 🫶

---

and that's the whole page bestie!! 🦋 this was rendered by perl v5.40.1, the page is dated 2025-12-07, and it lives under the name Net::A...CL::Set(3pm) in the Perl manual. slay, mwah 💋✨