EC2-IMPORT-VOLUME(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

💖 EC2-IMPORT-VOLUME 💖

okay bestie, welcome to ec2-import-volume, a User Commands girlie from the EC2 API command line tools ✨ it makes a brand new import volume task using the meta-data from the disk you hand it 🫶

✨ NAME ✨

ec2-import-volume — create a new import volume task using meta-data from the given disk 💅

✨ SYNOPSIS ✨

ec2ivol ([ec2iv, ec2-import-volume])
ec2ivol [GENERAL OPTIONS] [SPECIFIC OPTIONS] disk-image

like. she has three names and she answers to all of them. main character behaviour fr fr 👑

✨ GENERAL NOTES ✨

any command option or parameter can be passed a value of -, and that means “read the values for that option from stdin”. that's it. that's the whole note. slay 💖

✨ DESCRIPTION ✨

she creates a new import volume task using the meta-data from the disk image you give her 🎀

the volume size for the imported disk-image gets calculated automatically — unless you specify it yourself. she's smart like that, no cap ✨

✨ GENERAL OPTIONS ✨

  • -O, --aws-access-key KEY — your AWS Access Key ID. defaults to the value of the AWS_ACCESS_KEY environment variable (if it's set). 🔑
  • -W, --aws-secret-key KEY — your AWS Secret Access Key. defaults to the value of the AWS_SECRET_KEY environment variable (if it's set). 🤫
  • -T, --security-token TOKEN — AWS delegation token. defaults to the value of the AWS_DELEGATION_TOKEN environment variable (if it's 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 it's set). overrides the default. ⚠️ like, she still works but she's retired bestie
  • -C, --cert CERT — [DEPRECATED] specify CERT as the X509 certificate to use. defaults to the value of the EC2_CERT environment variable (if it's set). overrides the default. ⚠️ same energy, also deprecated
  • -U, --url URL — specify URL as the web service URL to use. defaults to the value of https://ec2.amazonaws.com (us-east-1) or to that of the EC2_URL environment variable (if it's 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. this option 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. window shopping, but for permissions 💅
  • -v, --verbose — verbose output. she will yap 🗣️
  • -?, --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 ✨

  • -f, --format FORMAT — the file format of the disk image. refer to the latest Developer's Guide for valid values. [REQUIRED] 🚨
  • -s, --volume-size SIZE — the size of the EBS volume, in GiB (2^30 bytes), that will hold the converted image. if this option is omitted, the required volume size will be computed from the image file. 🧮
  • -z, --availability-zone ZONE — specifies the availability zone for the imported disk-image. run the ec2-describe-availability-zones command for a list of values, and see the latest Developer's Guide for their meanings. [REQUIRED] 🚨
  • -b, --bucket BUCKET — S3 destination bucket name for the manifest. [REQUIRED, unless the option --manifest-url is specified] 🪣
  • -o, --owner-akid OWNERAKID — AWS Access Key Id of the owner of BUCKET. 🗝️
  • -w, --owner-sak SECRETKEY — AWS Secret Access Key of the owner of BUCKET, used to sign the import-manifest URL. this parameter value is not sent to EC2. [REQUIRED] 🚨
  • --prefix PREFIX — prefix for the manifest-file and disk-image file parts within the S3 bucket. [OPTIONAL] ✨
  • --manifest-url url — optionally, specify the URL for an existing import-manifest file already uploaded to S3 [OPTIONAL]. this option cannot be specified if --bucket has been specified. 🚫 pick one, bestie, you can't have both
  • -d, --description DESCRIPTION — an optional, free-form comment that will be returned verbatim during subsequent calls to ec2-describe-conversion-tasks. maximum length is 240 characters. 📝
  • -x, --expires DAYS — validity period for the signed S3 URLS that allow EC2 to access the manifest. defaults to 30 days. [OPTIONAL] 📅
  • --ignore-region-affinity — ignore the verification check to determine that the bucket's S3 region matches the EC2 region where the conversion-task is created. 🙈
  • --user-threads THREADS — maximum number of threads to concurrently upload the file with. defaults to 20 threads. [OPTIONAL] 🧵
  • --dry-run — do not create a import task, only validate the disk image. 🧪
  • --dont-verify-format — do not verify the file format. this is dangerous and may result in a failed conversion. USE AT YOUR OWN RISK. 💀
  • --no-upload — do not upload a disk image to S3. to complete the import task, requires upload using ec2-resume-import. 📤

✨ SEE ALSO ✨

and that's the whole page bestie, you ate that 🍓✨ this was EC2 API command line tools 1.6.14.1, api=2014-05-01, served up for EC2-IMPORT-VOLUME(1) — go import something iconic 💖🦋💅

📦 where this page comes from