EC2-DESCRIBE...CES-OFFERINGS(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

💖 EC2-DESCRIBE-RESERVED-INSTANCES-OFFERINGS 💖

okay bestie, welcome to the manual page for ec2-describe-reserved-instances-offerings — part of the EC2 API command line tools, living in the User Commands section of your friendly neighbourhood man setup. she's long, she's a mouthful, and she's gonna help you go shopping for Reserved Instances. let's get into it 🛍️✨

🌸 NAME 🌸

ec2-describe-reserved-instances-offerings — describe available reserved instances. that's it, that's the whole job. iconic.

🦋 SYNOPSIS 🦋

 ec2drio ([ec2-describe-reserved-instances-offerings])
 ec2drio [GENERAL OPTIONS] [OFFERING [OFFERING [...]]] [-z ZONE] [-t
INSTANCE-TYPE] [-d DESCRIPTION] [--tenancy TENANCY] [--offering-type
OFFERING-TYPE]
not me noticing the short alias is ec2drio because ec2-describe-reserved-instances-offerings is literally a whole paragraph 💀 thank u for the mercy

✨ GENERAL NOTES ✨

so, real talk: any command option or parameter can be handed a value of - — and that's your lil signal that the values for that option should be read from stdin instead. pipe it in, queen 🫶

💅 DESCRIPTION 💅

this command returns information about Reserved Instance offerings that are available for purchase. no cap.

and if you pass no parameter at all? it'll just give you info about all the Reserved Instance offerings. the whole buffet. the entire menu. everything on the shelf. slay 🔥

👑 GENERAL OPTIONS 👑

the shared, universal, everybody-gets-these options. main character energy for all the ec2 tools:

  • -O, --aws-access-key KEY — your AWS Access Key ID. defaults to whatever's in the AWS_ACCESS_KEY environment variable (if it's set).
  • -W, --aws-secret-key KEY — your AWS Secret Access Key. defaults to the AWS_SECRET_KEY environment variable (if set). keep this one secret bestie, fr fr 🤫
  • -T, --security-token TOKEN — 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), and overrides the default.
  • -C, --cert CERT — [DEPRECATED] specify CERT as the X509 certificate to use. defaults to the value of the EC2_CERT environment variable (if set), and overrides the default.
  • -U, --url URL — specify URL as the web service URL to use. defaults to https://ec2.amazonaws.com (that's 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 one overrides the URL you set with -U URL and the EC2_URL environment variable. it defaults to the region specified by the EC2_URL environment variable, or us-east-1 if that variable isn't set.
  • -D, --auth-dry-run — check whether you can perform the requested action instead of actually doing it. a lil test run, a dress rehearsal, no commitment 💅
  • -v, --verbose — verbose output. give me all the details.
  • -?, --help — display this help.
  • -H, --headers — display column headers. so you actually know what column is what.
  • --debug — display additional debugging information.
  • --show-empty-fields — indicate empty fields.
  • --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.
the two [DEPRECATED] ones are deprecated okay, i'm not being dramatic, the manpage literally says so 😭 don't build new stuff on them

🎀 SPECIFIC OPTIONS 🎀

these ones are special to this command, aka the fun part:

  • -z, --availability-zone ZONE — find offerings in the specifed availability zone.
  • -t, --type INSTANCE-TYPE — find offerings for the specified instance type.
  • -d, --description DESCRIPTION — find offerings containing the following product description.
  • --tenancy TENANCY — specifies the tenancy of the instances, which can be default or dedicated.
    • default: tenancy is not restricted.
    • dedicated: the instance will run on single-tenant hardware, and additional charges will apply. 💸 heads up.
  • --offering-type OFFERING-TYPE — specifies the offering type, which relates to the billing model used for the offering.
  • -F, --filter FILTER — add a filter criterion for the result-set.
  • --exclude-marketplace — specifies that Reserved Instance Marketplace offerings should not be shown in the results. bye felicia 👋
  • --min-duration MIN-DURATION — specifies that only results which have a duration of at least MIN-DURATION months should be returned.
  • --max-duration MAX-DURATION — specifies that only results which have a duration of at most MAX-DURATION months should be returned.

🌈 SEE ALSO 🌈

go read the lore, bestie:

and that's the whole page, you ate that 💖 this was the ec2-describe-reserved-instances-offerings page from the <strong>EC2 API command line tools</strong>, version <strong>1.6.14.1</strong>, api=<strong>2014-05</strong> (yes it's vintage, it's giving 2014 and we love her for it). now go describe some offerings, periodt 👑✨

📦 where this page comes from