Retrieve

Retrieve an Existing Image

get/v2/images/{image_id}

To retrieve information about an image, send a GET request to /v2/images/$IDENTIFIER.

Path Parameters

image_idunion

number OR string

Hide ParametersShow Parameters

UnionMember0number

UnionMember1string

Returns

imageidnumbercreated_atstringdescriptionstringdistributionenumerror_messagestringmin_disk_sizenumbernamestringpublicbooleanregionsarray of enumsize_gigabytesnumberslugstringstatusenumtagsarray of stringtypeenumImage

HTTPPython

curl https://api.digitalocean.com//v2/images/$IMAGE_ID \
    -H "Authorization: Bearer $GRADIENTAI_API_KEY"

200 Example

{
  "image": {
    "created_at": "2020-05-04T22:23:02Z",
    "description": " ",
    "distribution": "Ubuntu",
    "error_message": " ",
    "min_disk_size": 20,
    "name": "Nifty New Snapshot",
    "public": true,
    "regions": [
      "nyc1",
      "nyc2"
    ],
    "size_gigabytes": 2.34,
    "slug": "nifty1",
    "status": "NEW",
    "tags": [
      "base-image",
      "prod"
    ],
    "type": "snapshot"
  }
}