Image View

v1.0.0

Get information about a single Image.

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 a public Image, call this endpoint with or without authentication. To view a private Image, call this endpoint with authentication.

Output

{
  "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"
    }
  }
}