VM::EC2::KeyPair(3pm)

💖 VM::EC2::KeyPair 💖

okay bestie, so this is a page from the User Contributed Perl Documentation and it's all about VM::EC2::KeyPair — the little object that describes an Amazon EC2 ssh key pair. ssh keys but make it cloud. iconic behavior honestly. 🔑✨

---

✨ NAME ✨

VM::EC2::KeyPair — an object that describes an Amazon EC2 ssh key pair 🦋

---

🎀 SYNOPSIS 🎀

use VM::EC2;

$ec2     = VM::EC2->new(...);
@pairs   = $ec2->describe_key_pairs();

foreach (@pairs) {
    $fingerprint = $_->keyFingerprint;
    $name        = $_->keyName;
}

$newkey = $ec2->create_key_pair("fred's key");
print $newkey->privateKey;

---

🌸 DESCRIPTION 🌸

so like, this object is an Amazon EC2 ssh key pair. that's it, that's the whole vibe. it gets handed back to you by VM::EC2->describe_key_pairs(). main character energy from a tiny little data holder, we love to see it 💅

---

👑 METHODS 👑

these object methods are supported, no cap:

• keyName — the name of the key, like for real for real, e.g. "fred-default" 🌈
• name — a shorter version of keyName(), because sometimes you just don't have the time 🫶
• keyFingerprint — the key's fingerprint 🔍
• fingerprint — a shorter version of keyFingerprint() ✨
• keyMaterial — the PEM encoded RSA private key. heads up bestie: this one is ONLY available when you're creating a new key 😭
• privateKey — the more intuitive version of keyMaterial() 💖

---

🦋 STRING OVERLOADING 🦋

when you use this object in a string context, it interpolates the keyName. so it just… becomes its name. casual. effortless. ate 💅

---

⭐ SEE ALSO ⭐

VM::EC2 VM::EC2::Generic

---

💜 AUTHOR 💜

Lincoln Stein <lincoln.stein@gmail.com>.

Copyright (c) 2011 Ontario Institute for Cancer Research

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty.

---

🎀 and that's the whole page bestie, you're officially a VM::EC2::KeyPair expert, no notes 🎀

kisses, this was documented with perl v5.38.2 on 2024-08-10 💖 mwah 💖