Retrieve a specific GPU in a VM

This topic explains how to retrieve the details of a single, specific Graphics Processing Unit (GPU) attached to the Cloud GPU VM.

Endpoint

Use the following endpoint for templates: https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{serverId}/gpus/{gpuId}

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/{gpuId}' \
--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 the complete details of the requested GPU resource.

{
	"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]"
	}
}