Retrieve list of GPUs in a VM

This topic explains how to retrieve a list of all Graphics Processing Unit (GPU) cards that are currently attached to a specific server within a Virtual Data Center (VDC). This API request is useful for auditing the resources of a server or verifying a successful GPU attachment.

Endpoint

Use the following endpoint for templates: https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{serverId}/gpus?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/datacenters/{datacenterId}/servers/{serverId}/gpus' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json'

Header Parameters

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

Name	Type	Description
Authorization	string	The bearer token.
Content-Type	string	Must be application/json.

Path Parameters

Query Parameters

Response

A successful request returns a 200 status code and a JSON collection containing a list of GPU resources attached to the specified server.

		{
			"id": "f58b1946-c83f-4e70-adcb-2377a232047e",
			"type": "gpu",
			"href": "https://api.ionos.com/cloudapi/v6/datacenters/adc847be-f4f9-4ccc-83f3-5a320d68de39/servers/569738de-a605-40c5-8611-ccc625096a2c/gpus/f58b1946-c83f-4e70-adcb-2377a232047e",
			"metadata": {
		        "etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
                "createdDate": "2015-12-04T14:34:09.809Z",
                "createdBy": "[email protected]",
                "createdByUserId": "7ebaf38d-1234-5c8b-dc1c-c68089f684a0",
		        "lastModifiedDate": "2015-12-04T14:34:09.809Z",
                "lastModifiedBy": "[email protected]",
                "lastModifiedByUserId": "7ebaf38d-1234-5c8b-dc1c-c68089f684a0",
   	            "state": "AVAILABLE"
			},
			"properties": {
				"name": "GPU NVIDIA Corporation GH100 [H200 NVL] 1",
				"vendor": "NVIDIA Corporation",
				"type": "passthrough",
				"model": "GH100 [H200 NVL]"
			}
     }