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/

Request

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

curl -X 'GET' \
  'https://api.ionos.com/cloudapi/v6/templates' \
  -H 'accept: 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

You can refine your request by adding the optional query parameter depth.

Name	Type	Description
depth	integer	Template detail depth. Default value is 0.

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,
        "category": "Template category"
      }
    }
  ]
}