EC2-REPORT-INSTANCE-STATUS(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

👑 EC2-REPORT-INSTANCE-STATUS(1) — the manual page, but make it make sense 💅

okay bestie, pull up a chair, we're reading a User Commands manual page together and honestly? it's giving "i have one very specific job and i do it." the command's full government name is ec2-report-instance-status, and yes you can also just call her ec2rep around friends. ✨

🌸 NAME 🌸

ec2-report-instance-status — Report a discrepancy in the status of one or more of your instances 🫶

like. the whole point. she reports when your instance's status is being shady.

🎀 SYNOPSIS 🎀

ec2rep ([ec2-report-instance-status])
ec2rep [GENERAL OPTIONS] INSTANCE [INSTANCE [...]] -status STATUS [-r REASON [-r REASON [...]]] [-d DESCRIPTION] [-s START-TIME] [-e END-TIME]

so you either run her bare, or you hand her some instances and a whole little story about what went wrong. both valid. both iconic. 💖

🧚 GENERAL NOTES 🧚

Any command option/parameter may be passed a value of - to indicate that values for that option should be read from stdin.

like, literally any of them. pass a - and she'll read it off stdin instead. no cap, that's just a thing she does. 🍓

🦋 DESCRIPTION 🦋

Report a discrepancy in the status of one or more of your instances.

the INSTANCE parameter is the instance ID(s) to report on. that's it. that's the whole job. she takes your instance IDs, she tattles on their status, everyone moves on with their lives. 🌈

✨ GENERAL OPTIONS ✨

these are the universal ones, the ones every tool in the family shares. slay.

  • -O, --aws-access-key KEY — your AWS Access Key ID. defaults to whatever's in the AWS_ACCESS_KEY environment variable (if you set it, bestie).
  • -W, --aws-secret-key KEY — your AWS Secret Access Key. defaults to the AWS_SECRET_KEY environment variable (if it's set).
  • -T, --security-token TOKEN — the AWS delegation token. defaults to the AWS_DELEGATION_TOKEN environment variable (if set).
  • -K, --private-key KEY — [DEPRECATED] specify KEY as the private key to use. defaults to the value of the EC2_PRIVATE_KEY environment variable (if set). overrides the default. ⚠️ she's deprecated, she's retired, she's living her best life off the clock.
  • -C, --cert CERT — [DEPRECATED] specify CERT as the X509 certificate to use. defaults to the value of the EC2_CERT environment variable (if set). overrides the default. ⚠️ also deprecated. also iconic but in a legacy way.
  • -U, --url URL — specify URL as the web service URL to use. defaults to 'https://ec2.amazonaws.com' (us-east-1) or to the value of the EC2_URL environment variable (if set). overrides the default.
  • --region REGION — specify REGION as the web service region to use. this option will override the URL specified by the "-U URL" option and the EC2_URL environment variable. defaults to the region specified by the EC2_URL environment variable, or us-east-1 if that environment variable isn't set.
  • -D, --auth-dry-run — vibe check only: check if you can perform the requested action rather than actually performing it. 👀
  • -v, --verbose — verbose output. she'll yap. affectionately.
  • -?, --help — display this help.
  • -H, --headers — display column headers.
  • --debug — display additional debugging information.
  • --show-empty-fields — indicate empty fields. so you can see the void. 💀
  • --hide-tags — do not display tags for tagged resources.
  • --connection-timeout TIMEOUT — specify a connection timeout TIMEOUT (in seconds).
  • --request-timeout TIMEOUT — specify a request timeout TIMEOUT (in seconds).

💜 SPECIFIC OPTIONS 💜

these are her options. the ones that make her her. main character energy only.

  • -s, --status STATUS — report the instance as 'ok' or 'impaired'. two moods, no in-between. 💅
  • -r, --reason REASON_CODES — reason must be one of the following strings:
    • instance-stuck-in-state
    • unresponsive
    • not-accepting-credentials
    • password-not-available
    • performance-network
    • performance-instance-store
    • performance-ebs-volume
    • performance-other
    • other
  • -d, --description DESCRIPTION — descriptive text that provides the details about the instance(s) status. can be up to 1000 characters long. spill the tea, but like, within 1000 characters.
  • -s, --start-time START_TIME — an optional date field indicating the time when the instance status started being incorrect. the date uses the format yyyy-MM-dd'T'HH:mm:ss, e.g. 2011-07-25T14:00:00.
  • -e, --end-time END_TIME — an optional date field indicating the time when the instance status ended being incorrect. the date uses the format yyyy-MM-dd'T'HH:mm:ss, e.g. 2011-07-25T14:00:00.
🫶 bestie heads up: the page lists -s for both --status and --start-time. i'm just the messenger. i am telling you exactly what the page says, character for character, because that is the assignment. read carefully, king. 👑

🔥 SEE ALSO 🔥

go read the docs, iykyk. 📚✨

and that's the whole page!! 💖 this one's from the EC2 API command line tools, version 1.6.14.1, api=2014-05-0. thanks for coming to my ted talk, go report some instance statuses, and remember: the facts never changed, only the vibe. periodt. 🎀🦋💅

📦 where this page comes from