EC2-MODIFY-RESERVED-INSTANCES(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

💖 ec2-modify-reserved-instances(1) — the glow-up edit for your Reserved Instances 💖

okay bestie, sit down, grab a strawberry matcha 🍓🍵 because we're about to talk about ec2-modify-reserved-instances, aka ec2mri for the girlies who don't have time to type all that. this is a User Commands manual page, section 1, and it's literally the tool that changes up your Reserved Instances. no cap.

✨ NAME ✨

ec2-modify-reserved-instances — modifies the Availability Zone, instance count, network platform 🦋

🌸 SYNOPSIS 🌸

ec2mri ([ec2-modify-reserved-instances])
ec2mri [GENERAL OPTIONS] RESERVED-INSTANCES-ID [RESERVED-INSTANCES-ID
       [...]] [--client-token TOKEN] -c TARGET-CONFIGURATION [-c
       TARGET-CONFIGURATION [...]]

so yeah, she has a little nickname, she takes a whole squad of Reserved Instance IDs, and she wants at least one -c to know where she's going. 💅

🎀 GENERAL NOTES 🎀

any command option/parameter can be handed a value of '-' and that means "bestie, read the values for this one off stdin". it's giving "I'll type it later, I promise." 😭

👑 DESCRIPTION 👑

she modifies the Availability Zone, the instance count, the network platform (that's EC2-Classic or EC2-VPC, pick your fighter), or the instance type of your Reserved Instances. iconic.

RESERVED-INSTANCES-IDs are the IDs of the Reserved Instances you wanna modify. and listen — those IDs have to refer to Reserved Instances that are identical, except for Availability Zone, network platform, and instance type. so like, twins. fr fr. 👯‍♀️

💅 GENERAL OPTIONS 💅

  • -O, --aws-access-key KEY — your AWS Access Key ID. defaults to whatever AWS_ACCESS_KEY is set to in your environment (if it's set at all, bestie).
  • -W, --aws-secret-key KEY — your AWS Secret Access Key. defaults to the value of the AWS_SECRET_KEY environment variable (if set).
  • -T, --security-token TOKEN — your AWS delegation token. defaults to the value of 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.
  • -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.
  • -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 option will override the URL specified by the -U URL option and the EC2_URL environment variable. it defaults to the region specified by the EC2_URL environment variable, or us-east-1 if that environment variable is not set. 🗺️
  • -D, --auth-dry-run — check if you can perform the requested action instead of actually performing it. it's the "rehearsal, not the show" option. 🎭
  • -v, --verbose — verbose output. she talks more. we love her for it.
  • -?, --help — display this help. your bestie when you're lost. 🫶
  • -H, --headers — display column headers.
  • --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).

🔥 SPECIFIC OPTIONS 🔥

the ones that make her her ✨

  • --client-token TOKEN — the client token for this request, which makes the call idempotent. a random client token will be generated if this is not provided. so if you don't bring one, she'll make one. resourceful. 💁‍♀️
  • -c, --target-configuration TARGET-CONFIGURATION — new configuration settings for the Reserved Instances. ngl this is the main character of the whole page.

each configuration is specified by comma-separated, key-value pairs wrapped in double quotes. the key names are zone, count, platform, and instance-type.

  • zone and count are required. no skipping, bestie. 🙅‍♀️
  • platform is optional if your account supports EC2-VPC; it must be specified if your account supports EC2-Classic.
  • instance-type must be of the same instance family as the input Reserved Instances, and it defaults to the instance type of the input Reserved Instances when not specified.
  • refer to the latest Developer's Guide for valid values. 📖

Example 1 (modifying a Reserved Instance to one configuration) 🌈

ec2mri <RESERVED-INSTANCES-ID> -c "zone=us-east-1a,count=1,platform=EC2-VPC,instance-type=m1.medium"

Example 2 (modifying multiple Reserved Instances to multiple configurations) 🌈

ec2mri <RESERVED-INSTANCES-ID-1> <RESERVED-INSTANCES-ID-2>
   -c "zone=us-east-1a,count=1,platform=EC2-VPC,instance-type=m1.medium"
   -c "zone=us-east-1b,count=2,platform=EC2-Classic,instance-type=m1.small"

see how she stacks those -cs? one per configuration. slay. 💅

🦋 SEE ALSO 🦋

go read the docs, they're giving reference material energy. 📚

and that's the whole page, bestie!! 🎀 this was brought to you by the EC2 API command line tools, version 1.6.14.1, api=2014-0. mwah, go modify something responsibly. 💖✨🫶

📦 where this page comes from