Retrieve Template list

You can retrieve a list of configuration templates that are currently available. Instances have a fixed configuration of vCPU, RAM, and direct-attached storage size.

Endpoint

Use the following endpoint for templates: https://api.ionos.com/cloudapi/v6/templates/?depth=3

Request

Note: The following request contains sample values. Remember to replace them with the relevant information.

curl --location \
--request GET 'https://api.ionos.com/cloudapi/v6/templates/?depth=3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json'

Path Parameters

To make authenticated requests to the API, the following fields are mandatory in the request header:

Name	Type	Description
v6	string	The API version.
templates	string	Template attributes: ID, metadata, and properties.

Query Parameters

Response

A 200 message confirms that the templates list is fetched.

{
  "id": "15f67991-0f51-4efc-a8ad-ef1fb31a480c",
  "type": "collection",
  "href": "<RESOURCE-URI>",
  "items": [
    {
      "id": "15f67991-0f51-4efc-a8ad-ef1fb31a480c",
      "type": "template",
      "href": "<RESOURCE-URI>",
      "metadata": {
        "etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
        "createdDate": "2015-12-04T14:34:09.809Z",
        "createdBy": "[email protected]",
        "createdByUserId": "[email protected]",
        "lastModifiedDate": "2015-12-04T14:34:09.809Z",
        "lastModifiedBy": "[email protected]",
        "lastModifiedByUserId": "63cef532-26fe-4a64-a4e0-de7c8a506c90",
        "state": "AVAILABLE"
      },
      "properties": {
        "name": "My resource",
        "cores": 2,
        "ram": 2048,
        "storageSize": 10,
        "storageType": "SSD Premium",
        "category": "Template category",
        "gpus": [
          {
            "vendor": "NVIDIA",
            "model": "A100",
            "type": "passthrough",
            "count": 0
          }
        ]
      }
    }
  ]
}