MDATA-GET(1)

✨ MDATA-GET ✨

ok so bestie, let me put you onto mdata-get — it's a lil metadata-fetching icon from the Metadata Commands squad 💅

🎀 NAME 🎀

mdata-get — go grab the value of a metadata key-value pair. that's it, that's the job 🫶

🌸 SYNOPSIS 🌸

/usr/sbin/mdata-get keyname

🦋 DESCRIPTION 🦋

okay so here's the vibe: mdata-get lets you — or a script, scripts are valid too 💖 — query the metadata for a guest instance that's living its best life inside a SmartDataCenter (SDC) cloud. it's giving main character energy for automation, fr fr.

where does this metadata even come from, you ask? great question bestie:

• generally it's set programmatically via CloudAPI ✨
• or during interactive provisioning through a Web Portal 🎀
• and you can also set it from inside the instance itself with the mdata-put command 👑

the value of the keyname you asked for gets printed to stdout — no cap. now here's the part you gotta know:

if the metadata service is unavailable when you make the request, this command will block, just sitting there waiting for it to become available. patient queen. 🧘‍♀️

non-transient failures — like, say, the keyname you asked for literally doesn't exist — will make the program exit with a non-zero status. and depending on the nature of the error, some diagnostic output may get printed to stderr. not me being messy on stderr 😭

💀 EXIT STATUS 💀

the following exit values are returned — memorize these, iykyk:

• 0 — Successful completion. the keyname you wanted was available and its value was emitted to stdout. slay! 🎉
• 1 — Metadata value not found. the requested keyname was not found in the metadata. it's simply not there, bestie 🙈
• 2 — An error occurred. an unexpected error condition happened, and it's believed to be a non-transient condition. retrying the request is not expected to resolve it — either a software bug or a misconfiguration exists. so like… it's not a you-problem you can retry your way out of 🔥
• 3 — A usage error occurred. malformed arguments were passed to the program. go check the usage instructions and make sure you're supplying valid arguments, bestie, because that one's on you 🫠

👀 SEE ALSO 👀

mdata-delete(1), mdata-list(1), mdata-put(1) — the whole friend group, go say hi 💜

and that's the tea, bestie 🍓 this page came to you courtesy of Joyent SmartDataCenter, dated October 2013 — a vintage queen serving looks since forever 👑✨💖