ISOs

List ISOs

Returns all available ISO objects.

get/isos

Request

  • Base URL: https://api.hetzner.cloud/v1
  • URL: https://api.hetzner.cloud/v1/isos
  • Auth: HTTP bearer

Query parameters

namestring

Filter resources by their name.

The response will only contain the resources matching exactly the specified name.

architecture'x86' | 'arm'

CPU architecture of the Resource.

Example:x86

Filter resources by cpu architecture.

The response will only contain the resources with the specified cpu architecture.

include_architecture_wildcardboolean

Include Images with wildcard architecture (architecture is null). Architecture filter must be specified.

pageinteger
Example:1

Page number to return. For more information, see "Pagination".

per_pageinteger
Example:25

Maximum number of entries returned per page. For more information, see "Pagination".

Response

Request succeeded.

Example response

{
  "isos": [
    {
      "id": 42,
      "name": "FreeBSD-11.0-RELEASE-amd64-dvd1",
      "description": "FreeBSD 11.0 x64",
      "deprecation": {
        "unavailable_after": "2023-09-01T00:00:00Z",
        "announced": "2023-06-01T00:00:00Z"
      },
      "architecture": "x86"
    }
  ],
  "meta": {
    "pagination": {
      "page": 3,
      "per_page": 25,
      "previous_page": 2,
      "next_page": 4,
      "last_page": 4,
      "total_entries": 100
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.