Images
v4.83.1 Images List GET
https://api.linode.com/v4/images
Returns a paginated list of Images.
Calling this endpoint without authentication returns all public Images. Authentication is required to return a combined paginated list of all public and
your private Images. Authorizations personalAccessToken oauth images:read_only
Query Parameters page Type: integer
>= 1Default:
1
Default: 1 The page of a collection to return.
page_size Type: integer
25..100Default:
100
Default: 100 The number of items to return per page.
Request Samples
Shell
CLI
curl https://api.linode.com/v4/images
Response Samples
200
default
{
"data" : [
{
"created" : "2018-01-01T00:01:01" ,
"created_by" : "linode" ,
"deprecated" : false ,
"description" : null ,
"eol" : "2200-10-23T00:00:00" ,
"expiry" : null ,
"id" : "linode/ubuntu17.10" ,
"is_public" : true ,
"label" : "Ubuntu 17.10" ,
"size" : 2500 ,
"type" : "manual" ,
"updated" : "2019-01-02T00:01:01" ,
"vendor" : "Ubuntu"
}
],
"page" : 1 ,
"pages" : 1 ,
"results" : 1
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
A paginated list of Images.
array of objects
string <date-time>
When this Image was created.
string
The name of the User who created this Image, or “linode” for official Images.
boolean
Whether or not this Image is deprecated. Will only be true for deprecated public Images.
string
A detailed description of this Image.
string <date-time>
The date of the image’s planned end of life. Some images, like custom private images, will not have an end of life date. In that case this field will be None.
string <date-time>
Only Images created automatically (from a deleted Linode; type=automatic) will expire.
string
The unique ID of this Image.
boolean
True if the Image is public.
string
A short description of the Image.
integer
The minimum size this Image needs to deploy. Size is in MB.
stringEnum:
manual
automatic
How the Image was created. Manual Images can be created at any time. “Automatic” Images are created automatically from a deleted Linode.
string <date-time>
When this Image was last updated.
string
The upstream distribution vendor. None for private Images.
integer
integer
integer
Error
array of objects
string
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as “null” if the error is not specific to any single element of the request.
string
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to
open a Support Ticket or perform some other action before you can complete the request successfully.
Image Create POST
https://api.linode.com/v4/images
Creates a private gold-master Image from a Linode Disk. There is no additional charge to store Images for Linode users.
Images are limited to three per Account.
Authorizations personalAccessToken oauth images:read_write
Request Body Schema string
A detailed description of this Image.
integer
The ID of the Linode Disk that this Image will be created from.
string
A short title of this Image. Defaults to the label of the Disk it is being created from if not provided.
Request Samples
Shell
CLI
curl -H "Content-Type: application/json" \
"Authorization: Bearer $TOKEN " \
'{
"disk_id": 123,
"label": "this_is_a_label",
"description": "A longer description of the image"
}' \
linode-cli images create \
\
"A longer description \
of the image" \
123
Response Samples
200
default
{
"created" : "2018-01-01T00:01:01" ,
"created_by" : "somename" ,
"deprecated" : false ,
"description" : "The detailed description of my Image." ,
"eol" : "2200-10-23T00:00:00" ,
"expiry" : "2018-08-01T00:01:01" ,
"id" : "private/67848373" ,
"is_public" : false ,
"label" : "My gold-master image" ,
"size" : 2500 ,
"type" : "manual" ,
"updated" : "2019-01-02T00:01:01" ,
"vendor" : null
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
New private Image created successfully.
string <date-time>
When this Image was created.
string
The name of the User who created this Image.
boolean
Whether or not this Image is deprecated. Will only be True for deprecated public Images.
string
A detailed description of this Image.
string <date-time>
The date of the image’s planned end of life. Some images, like custom private images, will not have an end of life date. In that case this field will be None.
string <date-time>
Only Images created automatically (from a deleted Linode; type=automatic) will expire.
string
The unique ID of this Image.
boolean
True if the Image is public.
string
A short description of the Image. Labels cannot contain special characters.
integer
The minimum size this Image needs to deploy. Size is in MB.
stringEnum:
manual
automatic
How the Image was created. “Manual” Images can be created at any time. “Automatic” images are created automatically from a deleted Linode.
string <date-time>
When this Image was last updated.
string
The upstream distribution vendor. None for private Images.
Error
array of objects
string
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as “null” if the error is not specific to any single element of the request.
string
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to
open a Support Ticket or perform some other action before you can complete the request successfully.
Image Delete DELETE
https://api.linode.com/v4/images/{imageId}
Deletes a private Image you have permission to read_write.
Deleting an Image is a destructive action and cannot be undone.
Authorizations personalAccessToken oauth images:read_write
Path Parameters imageId string
Required ID of the Image to look up.
Request Samples
Shell
CLI
curl -H "Authorization: Bearer $TOKEN " \
\
linode-cli images delete 67848373
Response Samples
200
default
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
Error
array of objects
string
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as “null” if the error is not specific to any single element of the request.
string
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to
open a Support Ticket or perform some other action before you can complete the request successfully.
Image View GET
https://api.linode.com/v4/images/{imageId}
Get information about a single Image.
Authorizations Path Parameters imageId string
Required ID of the Image to look up.
Request Samples
Shell
CLI
curl https://api.linode.com/v4/images/linode/debian9
linode-cli images view linode/debian9
Response Samples
200
default
{
"created" : "2018-01-01T00:01:01" ,
"created_by" : "somename" ,
"deprecated" : false ,
"description" : "The detailed description of my Image." ,
"eol" : "2200-10-23T00:00:00" ,
"expiry" : "2018-08-01T00:01:01" ,
"id" : "private/67848373" ,
"is_public" : false ,
"label" : "My gold-master image" ,
"size" : 2500 ,
"type" : "manual" ,
"updated" : "2019-01-02T00:01:01" ,
"vendor" : null
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
A single Image object.
string <date-time>
When this Image was created.
string
The name of the User who created this Image.
boolean
Whether or not this Image is deprecated. Will only be True for deprecated public Images.
string
A detailed description of this Image.
string <date-time>
The date of the image’s planned end of life. Some images, like custom private images, will not have an end of life date. In that case this field will be None.
string <date-time>
Only Images created automatically (from a deleted Linode; type=automatic) will expire.
string
The unique ID of this Image.
boolean
True if the Image is public.
string
A short description of the Image. Labels cannot contain special characters.
integer
The minimum size this Image needs to deploy. Size is in MB.
stringEnum:
manual
automatic
How the Image was created. “Manual” Images can be created at any time. “Automatic” images are created automatically from a deleted Linode.
string <date-time>
When this Image was last updated.
string
The upstream distribution vendor. None for private Images.
Error
array of objects
string
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as “null” if the error is not specific to any single element of the request.
string
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to
open a Support Ticket or perform some other action before you can complete the request successfully.
Image Update PUT
https://api.linode.com/v4/images/{imageId}
Updates a private Image that you have permission to read_write.
Authorizations personalAccessToken oauth images:read_write
Path Parameters imageId string
Required ID of the Image to look up.
Request Body Schema string
A detailed description of this Image.
string
A short description of the Image. Labels cannot contain special characters.
Request Samples
Shell
CLI
curl -H "Content-Type: application/json" \
"Authorization: Bearer $TOKEN " \
'{
"label": "My gold-master image",
"description": "The detailed description of my Image."
}' \
linode-cli images update private/67848373 \
"My gold-master image" \
"The detailed description \
of my Image."
Response Samples
200
default
{
"created" : "2018-01-01T00:01:01" ,
"created_by" : "somename" ,
"deprecated" : false ,
"description" : "The detailed description of my Image." ,
"eol" : "2200-10-23T00:00:00" ,
"expiry" : "2018-08-01T00:01:01" ,
"id" : "private/67848373" ,
"is_public" : false ,
"label" : "My gold-master image" ,
"size" : 2500 ,
"type" : "manual" ,
"updated" : "2019-01-02T00:01:01" ,
"vendor" : null
}
{
"errors" : [
{
"field" : "fieldname" ,
"reason" : "fieldname must be a valid value"
}
]
}
Responses
200
default
The updated image.
string <date-time>
When this Image was created.
string
The name of the User who created this Image.
boolean
Whether or not this Image is deprecated. Will only be True for deprecated public Images.
string
A detailed description of this Image.
string <date-time>
The date of the image’s planned end of life. Some images, like custom private images, will not have an end of life date. In that case this field will be None.
string <date-time>
Only Images created automatically (from a deleted Linode; type=automatic) will expire.
string
The unique ID of this Image.
boolean
True if the Image is public.
string
A short description of the Image. Labels cannot contain special characters.
integer
The minimum size this Image needs to deploy. Size is in MB.
stringEnum:
manual
automatic
How the Image was created. “Manual” Images can be created at any time. “Automatic” images are created automatically from a deleted Linode.
string <date-time>
When this Image was last updated.
string
The upstream distribution vendor. None for private Images.
Error
array of objects
string
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as “null” if the error is not specific to any single element of the request.
string
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to
open a Support Ticket or perform some other action before you can complete the request successfully.
