Net::A...on::IAM(3pm)

💖 Net::Amazon::S3::Authorization::IAM 💖

okay bestie, welcome to the manual page for Net::Amazon::S3::Authorization::IAM — it's the IAM authorization information situation, and honestly? she's giving credentials, but make it fashion. ✨

This is a Perl module doc (a 3pm page, if you were wondering), from the User Contributed Perl Documentation, and she's literally here to hand your S3 object the keys to the kingdom. 🔑

---

🌸 NAME 🌸

Net::Amazon::S3::Authorization::IAM — IAM authorization information. that's it, that's the name, short and iconic. 👑

---

⭐ VERSION ⭐

version 0.992 — keep up, babes. 💅

---

🦋 SYNOPSIS 🦋

okay so here's how you actually use her. look at the code, no cap:

use Net::Amazon::S3;
use Net::Amazon::S3::Authorization::IAM;

# obtain instance credentials
use VM::EC2::Security::CredentialCache;
my $s3 = Net::Amazon::S3->new (
    authorization_context => Net::Amazon::S3::Authorization::IAM->new,
    ...
);

# or just provide your values
my $s3 = Net::Amazon::S3->new (
    authorization_context => Net::Amazon::S3::Authorization::IAM->new (
        aws_access_key_id     => ...,
        aws_secret_access_key => ...,
        aws_session_token     => ...,
    ),
    ...
);

so like, two vibes: either you let her go grab instance credentials on her own (look at that VM::EC2::Security::CredentialCache moment 💫), OR you just hand her your values directly like the generous bestie you are. your call, both slay. 🫶

---

💜 DESCRIPTION 💜

Authorization context using instance session credentials. 🪪

Unless specified, the authorization context obtains credentials via VM::EC2::Security::CredentialCache. and listen — it is not listed as a Net::Amazon::S3 dependency. so don't come for her when it's not just sitting there in your dependency tree, okay? she's independent like that. 💅

---

😭 INCOMPATIBILITY WARNING 😭

okay so brace yourself, this is the serious part and I need you to actually read it. 🚨

This module with its dependencies will be moved out and distributed separately without dependency from Net::Amazon::S3.

so it's moving out, getting her own apartment, being her own module. main character era fr fr.

If you use IAM, please consider to add proper use statement into your code. like, literally just put it in there yourself. don't wait for the transitive dependency to do it for you, because she's leaving and she's not taking you with her. 😭

bestie. add the use statement. it's giving "future you will thank present you". no cap. 🫶

---

🌈 AUTHOR 🌈

Branislav Zahradník <barney@cpan.org> — the icon, the moment, the legend. 👑

---

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2025 by Amazon Digital Services, Leon Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav Zahradník. a whole squad, a whole committee, we love a collaborative slay. ✨

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so go off, remix it, redistribute it, it's yours. 💖

---

aaaand that's the whole page bestie, you made it to the end, so proud. 🥹 this was perl v5.40.1, dated 2025-12-07, and yes, it's still the Net::A...on::IAM(3pm) page — even with that lil ellipsis in the header, she's that mysterious. 💅✨ bye babe, go authorize something. 🦋🌸