Upload an image

Creates a new private image container and returns a URL as the upload_to object in the response. Use this URL to upload your own disk image to the container.

👍

There's a tutorial

This operation has specific requirements for use. Check out its workflow for details.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

• Identity and access permissions. Your user needs a role with these permissions. Learn more.

  • Permissions: upload_image

• OAuth scopes. Your user needs these scopes assigned. Learn more.

  • Scopes: images:read_write

CLI

# Run the operation to just get the upload_to URL
linode-cli images upload \
  --description "Optional details about the Image" \
  --label "Example Image" \
  --region us-east

# Upload the image file in a single step
linode-cli image-upload \
  --description "Optional details about the Image" \
  --label "Example Image" \
  --region us-east \
  /path/to/image-file.img.gz

Learn more