EC2-RESUME-IMPORT(1)

📦 version 1.6.14.1, in ubuntu jammy, ubuntu noble

✨ ec2-resume-import ✨

okay bestie, pull up a chair, because we're talking about ec2-resume-import — that's the manual page for the ec2-resume-import(1) tool, part of the EC2 API command line tools. it lives in the User Commands section and it's here to get your disk image uploaded, no cap. 💖

🌸 NAME 🌸

ec2-resume-import — upload the disk image associated with the conversion task id. that's it, that's the whole job. iconic. 💅

🦋 SYNOPSIS 🦋

 ec2rim ([ec2-resume-import])
 ec2rim [GENERAL OPTIONS] [SPECIFIC OPTIONS] disk-image

so yes, there's a little nickname: ec2rim. she's short, she's cute, she does the thing. 🎀

🎀 GENERAL NOTES 🎀

real talk, this applies to any command option or parameter: you can pass it a value of - to say "hey, read the values for this option from stdin instead." very demure, very mindful, very piping-friendly. 🫶

💜 DESCRIPTION 💜

so the whole vibe here is: you've got a conversion task id, and you've got a disk image, and this command uploads the disk image that belongs to that conversion task id. slay.

but listen — before anything gets uploaded, the disk image gets validated against the expected format for the conversion task. vibe check first, upload second. and if a previous upload attempt got aborted, the upload will (by default) resume from exactly where it was interrupted. not me being obsessed with resilience 😭💖

✨ GENERAL OPTIONS ✨

  • -O, --aws-access-key KEY — your AWS Access Key ID. defaults to whatever AWS_ACCESS_KEY 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 — AWS delegation token. defaults to the value of the AWS_DELEGATION_TOKEN environment variable (if set).
  • -K, --private-key KEY — [DEPRECATED] use KEY as the private key. defaults to the value of the EC2_PRIVATE_KEY environment variable (if set). overrides the default.
  • -C, --cert CERT — [DEPRECATED] use CERT as the X509 certificate. defaults to the value of the EC2_CERT environment variable (if set). overrides the default.
  • -U, --url URL — use URL as the web service URL. defaults to https://ec2.amazonaws.com (us-east-1) or to the value of the EC2_URL environment variable (if set). overrides the default.
  • --region REGION — use REGION as the web service region. 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 env var isn't set. she's got main character energy in the option list, fr fr.
  • -D, --auth-dry-run — checks whether you can do the requested action instead of actually doing it. little preview moment. 👀
  • -v, --verbose — verbose output. she talks more.
  • -?, --help — displays this help.
  • -H, --headers — displays column headers.
  • --debug — displays additional debugging information.
  • --show-empty-fields — indicates empty fields.
  • --hide-tags — do not display tags for tagged resources.
  • --connection-timeout TIMEOUT — set a connection timeout of TIMEOUT, in seconds.
  • --request-timeout TIMEOUT — set a request timeout of TIMEOUT, in seconds.

💅 SPECIFIC OPTIONS 💅

  • -t, --task TASK-ID — specifies the conversion task id for the upload. [REQUIRED] no skipping this one bestie.
  • -o, --owner-akid OWNERAKID — the AWS Access Key Id of the owner of BUCKET. [REQUIRED]
  • -w, --owner-sak SECRETKEY — the AWS Secret Access Key of the owner of BUCKET, used to sign URLs for accessing the file being uploaded to S3. heads up: this parameter value is not sent to EC2. [REQUIRED]
  • -x, --expires DAYS — how long the signed S3 URLS that let EC2 access your file stay valid. defaults to 30 days. [OPTIONAL]
  • --user-threads THREADS — the max number of threads used to concurrently upload the file. defaults to 20 threads. [OPTIONAL] parallel girly 💫
  • --dry-run — don't upload the file, only validate the disk image. all the vibe check, none of the commitment.
  • --dont-verify-format — don't verify the file format. 🚨 this is dangerous and may result in a failed conversion. not me telling you to leave this one alone, but like… leave this one alone. 🙈

👑 SEE ALSO 👑

go read, iykyk. 📚✨

and that's the whole page, bestie. any option or parameter can take - to read its values from stdin, remember that one, it's the little detail that carries. 🧚

ec2-resume-import(1) comes to you from the EC2 API command line tools, version 1.6.14.1, api=2014-05-01 — shoutout to the whole EC2 API command line tools crew, and to manual page EC2-RESUME-IMPORT(1) for holding it down in User Commands. periodt. 💖🎀🦋🌈⭐🍓

📦 where this page comes from