Retrieve list of GPUs in a VM
3 min
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' 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 to make authenticated requests to the api, the following fields are mandatory in the request header name type description v6 string the api version datacenterid string the id of the data center where the vm is located serverid string the id of the server, that is, the cloud gpu vm you can refine your request by adding the optional query parameter depth name type description depth string template detail depth default value is 0 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" "john doe\@example com", "createdbyuserid" "7ebaf38d 1234 5c8b dc1c c68089f684a0", 	 "lastmodifieddate" "2015 12 04t14 34 09 809z", "lastmodifiedby" "john doe\@example com", "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]" 	 } }
