API

Create an image

post
https://api.linode.com//images

Captures a private, gold image from a Linode disk and stores it for later use.

👍

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 the following:

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

    • Permissions: create_image

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

    • Scopes: images:read_write, linodes:read_only

CLI

linode-cli images create \
  --label this_is_a_label \
  --description "A longer description \
    of the image" \
  --disk_id 123

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
Body Params
boolean

Whether this image supports cloud-init.

string

A detailed description of this image.

integer
required

The ID of the target Linode disk for this image.

string

The short title for this image. If not provided, the disk's current label is used.

tags
array of strings
length between 0 and 500

Tags used for organizational purposes. A tag can be from 3 to 100 characters long, and an image can have a maximum of 500 total tags.

tags
Responses

Updated 17 days ago

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json

Updated 17 days ago