643 matches
100 actions
Linode
100 actions
Infrastructure/Linode
Returns a paginated list of Images.
Public Images have IDs that begin with "linode/". These distribution images are generally available to all users.
Private Images have IDs that begin with "private/". These Images are Account-specific and only accessible to Users with appropriate .
To view only public Images, call this endpoint with or without authentication. To view private Images as well, call this endpoint with authentication.
{
"type": "object",
"properties": {
"page": {
"type": "integer"
},
"page_size": {
"type": "integer"
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"description": "Image object",
"properties": {
"created": {
"type": "string",
"format": "date-time",
"description": "When this Image was created."
},
"created_by": {
"type": "string",
"description": "The name of the User who created this Image, or \"linode\" for public Images.\n"
},
"deprecated": {
"type": "boolean",
"description": "Whether or not this Image is deprecated. Will only be true for deprecated public Images.\n"
},
"description": {
"type": "string",
"description": "A detailed description of this Image."
},
"eol": {
"type": "string",
"format": "date-time",
"description": "The date of the public Image's planned end of life. `None` for private Images.\n"
},
"expiry": {
"type": "string",
"format": "date-time",
"description": "Only Images created automatically from a deleted Linode (type=automatic) will expire.\n"
},
"id": {
"type": "string",
"description": "The unique ID of this Image."
},
"is_public": {
"type": "boolean",
"description": "True if the Image is a public distribution image. False if Image is private Account-specific Image."
},
"label": {
"type": "string",
"description": "A short description of the Image.\n"
},
"size": {
"type": "integer",
"description": "The minimum size this Image needs to deploy. Size is in MB.\n"
},
"status": {
"type": "string",
"description": "The current status of this Image.\n\nOnly Images in an \"available\" status can be deployed. Images in a \"creating\" status are being created from a Linode Disk, and will become \"available\" shortly. Images in a \"pending_upload\" status are waiting for data to be [uploaded](/docs/api/images/#image-upload), and become \"available\" after the upload and processing are complete.\n\nThe \"+order_by\" and \"+order\" operators are not available for [filtering](/docs/api/#filtering-and-sorting) on this key.\n",
"enum": [
"creating",
"pending_upload",
"available"
]
},
"type": {
"type": "string",
"description": "How the Image was created.\n\n\"Manual\" Images can be created at any time.\n\n\"Automatic\" Images are created automatically from a deleted Linode.\n",
"enum": [
"manual",
"automatic"
]
},
"updated": {
"type": "string",
"format": "date-time",
"description": "When this Image was last updated."
},
"vendor": {
"type": "string",
"description": "The upstream distribution vendor. `None` for private Images.\n"
}
}
}
},
"page": {
"type": "integer",
"description": "The current [page](/docs/api/#pagination)."
},
"pages": {
"type": "integer",
"description": "The total number of [pages](/docs/api/#pagination)."
},
"results": {
"type": "integer",
"description": "The total number of results."
}
}
}