EC2-MODIFY-INSTANCE-ATTRIBUTE(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

👑 EC2-MODIFY-INSTANCE-ATTRIBUTE — the "change stuff about your instance" page 💅

okay bestie, this is ec2-modify-instance-attribute from the User Commands manual, and it's lowkey iconic. it's the tool that changes one lil thing about an EC2 instance. one. single. thing. per call. that's the vibe. ✨

🌸 NAME 🌸

ec2-modify-instance-attribute — Modify an instance attribute

🦋 SYNOPSIS 🦋

ec2minatt ([ec2-modify-instance-attribute, ec2miatt])
ec2minatt [GENERAL OPTIONS] [SPECIFIC OPTIONS] INSTANCE

💖 GENERAL NOTES 💖

so here's the tea, and it applies to literally every option and parameter on this page: you can pass a value of - to any command option/parameter, and that means "read the value for this thing from stdin instead." yes, all of them. no cap. 🫶

✨ DESCRIPTION ✨

it modifies an instance attribute. and bestie, hear me when i say this — only one attribute can be specified per call. one. don't try to be overachieving. 🙈

🎀 GENERAL OPTIONS 🎀

these are the options that every single command in this whole family shares. the group chat classics. 💜

  • -O, --aws-access-key KEY — your AWS Access Key ID. defaults to whatever the AWS_ACCESS_KEY environment variable is set to (if it's set at all).
  • -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), and it overrides the default. it's giving retired, but she's still on the page. 😭
  • -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 it 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 env var isn't set. main character energy, honestly.
  • -D, --auth-dry-run — check if you can perform the requested action rather than actually performing it. a little dress rehearsal. 🧚
  • -v, --verbose — verbose output.
  • -?, --help — display this help.
  • -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 🔥

this is where it gets juicy. pick one. that's the rule. periodt. 💅

  • -b, --block-device-mapping MAPPING — modifies the block-device-mapping for the instance, in the form '<device>=<block-device>', where 'block-device' can be one of the following:
    • '[<volume-id>][:<delete-on-termination>]' — indicates that an Amazon EBS volume should be exposed at the specified device. the following combinations are supported:
      • '<volume-id>' — the ID of the Amazon EBS volume, which must be owned by the caller.
      • '<delete-on-termination>' — indicates whether the Amazon EBS volume should be deleted on instance termination. if it's not specified, this will default to 'true' and the volume will be deleted.

for example:

'/dev/sdb=vol-7eb96d16
'/dev/sdc=vol-7eb96d16:false

see the latest Developer's Guide for further information. 📚

  • -t, --instance-type INSTANCETYPE — sets the instance-type of the specified instance to INSTANCETYPE.
  • --disable-api-termination BOOLEAN — sets whether to disallow the termination of the instance using the API. valid options are 'true' and 'false'.
  • --instance-initiated-shutdown-behavior BEHAVIOR — sets the behavior of the instance for an instance initiated shutdown (i.e. 'shutdown -h now').
    • 'stop' — indicates that the instance should move into the stopped state and remain available to be restarted.
    • 'terminate' — indicates that the instance should move into the terminated state.
  • --kernel KERNEL — sets the ID of the kernel to be used by the instance to KERNEL.
  • --ramdisk RAMDISK — sets the ID of the ramdisk to be used by the instance to RAMDISK.
  • --user-data USERDATA — sets the user data associated with the instance to USERDATA.
  • --source-dest-check BOOLEAN — sets whether to enable the source/dest check on traffic through this instance. valid options are 'true' and 'false'.
  • -g, --group-id GROUP_ID [ --group-id GROUP_ID [...]] — replace the security groups for a VPC instance.
  • --ebs-optimized BOOLEAN — provides dedicated throughput to Amazon EBS and a software stack optimized for EBS I/O. additional usage charges apply when using this option. bestie, that means money. 💀
  • --sriov SRIOV — set SR-IOV networking support for the instance.

🌈 SEE ALSO 🌈

💖 and that's the whole page, bestie. go forth and modify exactly one attribute at a time. i'm so proud of you. 🫶

this whole thing is from the EC2 API command line tools, version 1.6.14.1, API version 2014-0 (yes the version string on the footer is genuinely a lil cut off like that, we don't question it, we accept her as she is 💅). mwah, go slay. ✨🎀🦋

📦 where this page comes from