exo(1)

📦
version 1.102.1 · 2 versions
, in nixpkgs unstable

💅 exo(1) — the exo manual, bestie edition 🎀

Okay so this is the manual page for exo — specifically the exo-iam-role-create command, which lives in the exo man page family. Yes the page is named exo(1) and the command is exo-iam-role-create. It's giving "folder named after the assignment." Anyway. Let's go ✨

🌸 NAME 🌸

exo-iam-role-create — literally creates an IAM Role. That's the whole vibe. 👑

🦋 SYNOPSIS 🦋

exo iam role create NAME [flags]

You give it a NAME, you give it some [flags], it gives you a role. Iconic. 💅

✨ DESCRIPTION ✨

So this command creates a brand-new IAM Role, no cap. 🫶

And here's the cute part: if you want to read the Policy from STDIN, you just append - to the --policy flag. That's it. That's the trick. 💖

Pro Tip (and I mean pro pro tip, this one ate): you can reuse an existing role policy by feeding the output of the show command straight into it as input:

exo iam role show --policy --output-format json <role-name> | exo iam role create <new-role-name> --policy -

Look at that pipe. Look at it. Main character energy fr fr. 🌈

Supported output template annotations, and yes you need all of them: .ID, .Name, .Description, .Editable, .Labels, .Permissions, .Policy

💜 OPTIONS 💜

  • --description="" — the role description. Give your role a little personality. 💬
  • --editable[=true] — set --editable=false to prevent editing the Policy after creation. Locked in. 🔒 (yes, "do prevent" is what the original says, it's a whole mood, I'm not touching it)
  • -h, --help[=false] — help for create. When in doubt, ask for help. Self-care. 🎀
  • --label=[] — role labels, format is key=value. 🏷️
  • --permissions=[] — role permissions. The actual powers. ⚡
  • --policy="" — role policy (use - to read from STDIN). 🍓

🌟 OPTIONS INHERITED FROM PARENT COMMANDS 🌟

These are the family hand-me-downs, and honestly they're all bangers:

  • -C, --config="" — specify an alternate config file [env EXOSCALE_CONFIG] 📁
  • -O, --output-format="" — output format (table|json|text), see exo output --help for more information 👀
  • --output-template="" — template to use if output format is text 🧚
  • -Q, --quiet[=false] — quiet mode (disable non-essential command output). Shhh. 🤫
  • --timeout=15s — per-zone timeout for list operations; -1s disables timeout [env EXOSCALE_TIMEOUT] ⏰
  • -A, --use-account="" — account to use in config file [env EXOSCALE_ACCOUNT] 🪪

🫶 SEE ALSO 🫶

  • exo-iam-role(1) — go read the parent page, it's the source of all this lore 💖

📜 HISTORY 📜

1-Jan-1980 — Auto generated by spf13/cobra. The cobra did all the work and honestly? Respect. 🐍

Lowkey the most important part: this whole page is Auto generated by spf13/cobra, and it's dated Jan 1980 — which is before most of us were born but the vibes are timeless. 💀✨

That's the whole page, bestie — role created, policy piped, flags inherited, nothing skipped. Slay. 💅🎀

📦 where this page comes from