EC2-MODIFY-SNAPSHOT-ATTRIBUTE(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

💅 ec2-modify-snapshot-attribute — the manual page, but make it make sense

okay bestie, welcome to ec2-modify-snapshot-attribute(1), aka your little tool for messing with snapshot attributes. it lives in User Commands, it's iconic, and it's about to be your whole personality for the next five minutes. let's go 🦋

✨ NAME ✨

ec2-modify-snapshot-attribute — modify a snapshot attribute. that's it. that's the vibe. 💖

🌸 SYNOPSIS 🌸

ec2msnapatt ([ec2-modify-snapshot-attribute])
ec2msnapatt [GENERAL OPTIONS] SNAPSHOT -c ( -a ENTITY | -r ENTITY )

so you can call it ec2msnapatt (the cute nickname) or the whole long ec2-modify-snapshot-attribute thing. both slay. ✨

🎀 GENERAL NOTES 🎀

okay so this is important and also lowkey iconic: any command option or parameter can be handed the value -, and that means "bestie, read the values for that option from stdin instead." yeah. it's giving ✨pipes✨. 🫶

💖 DESCRIPTION 💖

you're modifying an attribute on a snapshot. that's the whole plot. the SNAPSHOT parameter is the ID of the snapshot you want to modify an attribute on, so like, don't forget it, no cap. 🌈

👑 GENERAL OPTIONS 👑

these ones are the shared, every-command options. the main characters, if you will.

  • -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, obvi). 🔑
  • -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. ⚠️ (yes, deprecated. we don't gatekeep, we just warn.)
  • -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. ⚠️ same energy.
  • -U, --url URL — specify URL as the web service URL to use. defaults to the value of https://ec2.amazonaws.com (that's us-east-1) or to whatever the EC2_URL environment variable says (if set). overrides the default. 🌐
  • --region REGION — specify REGION as the web service region to use. this option overrides the URL you set with 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 isn't set. 📍
  • -D, --auth-dry-run — check if you can even perform the requested action, instead of actually performing it. it's a vibe check for permissions, fr fr. 👀
  • -v, --verbose — verbose output. she's chatty. 🗣️
  • -?, --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 🔥

these are the ones that actually do the snapshot-attribute thing. the plot-specific girlies.

  • -c, --create-volume-permission — used together with the --add or --remove flags to, respectively, grant or revoke create volume permissions on the specified snapshot for the specified ENTITY. so -c plus -a = granting, -c plus -r = revoking. cute. 💅
  • -a, --add ENTITY [--add ENTITY...] — add a stated attribute, e.g. create volume permissions, to the specified ENTITY. valid ENTITY values are:
    • AWS Account ID: User ID to receive stated snapshot attribute.
    • all: All users to receive the stated snapshot attribute.

(and yeah you can stack it — --add ENTITY more than once, she's flexible. ✨)

  • -r, --remove ENTITY [--remove ENTITY...] — remove a stated attribute, e.g. create volume permissions, from the ENTITY specified. valid ENTITY values are:
    • AWS Account ID: User ID to lose stated snapshot attribute.
    • all: All users to lose the stated snapshot attribute.

(also stackable. go off. 💀)

reminder bestie: -a and -r are the two halves of the -c moment in the synopsis — -c ( -a ENTITY | -r ENTITY ) — so pick a side. 🫶

🌟 SEE ALSO 🌟

go read the lore, iykyk:

and that's the whole page, no skips, no crumbs left behind. this masterpiece ships as part of the EC2 API command line tools, version 1.6.14.1, api=2014-0... periodt. 💖✨🎀 go modify some snapshot attributes responsibly, bestie. 🦋👑

📦 where this page comes from