Get GPU instance
curl --request GET \
--url https://api.aireserve.com/v1/gpu/instances/{instanceId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aireserve.com/v1/gpu/instances/{instanceId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aireserve.com/v1/gpu/instances/{instanceId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"status": "requested",
"desiredState": "running",
"accelerator": {
"model": "<string>",
"count": 0
},
"runtime": {
"type": "container",
"profile": "<string>"
},
"location": {
"region": "<string>"
},
"storage": {
"rootGb": 0,
"rootPersistence": "ephemeral",
"volumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"persistent": {
"volumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sizeGb": 0,
"mountPath": "<string>",
"usdPerHour": "<string>",
"billsUntilDeleted": true,
"survivesStop": true,
"survivesTerminate": true,
"multiAttach": false,
"status": "<string>"
}
},
"price": {
"usdPerHour": "<string>",
"storageOnlyUsdPerHour": "<string>"
},
"capabilities": {
"start": true,
"stop": true,
"restart": true,
"ssh": true,
"logs": true,
"persistentVolumes": true,
"stopPreservesRootDisk": true
},
"recovery": {
"policy": {
"mode": "none",
"maxAttempts": 5,
"cooldownMinutes": 60
},
"attempts": 0,
"maxAttempts": 0,
"lastAttemptAt": "2023-11-07T05:31:56Z",
"lastOutcome": "recovering"
},
"createdAt": "2023-11-07T05:31:56Z",
"lastError": "<string>"
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}GPU Infrastructure
Get GPU instance
Retrieve normalized lifecycle, runtime profile, storage, price, and capabilities without provider placement identifiers or connection credentials. Requires compute read access.
GET
/
v1
/
gpu
/
instances
/
{instanceId}
Get GPU instance
curl --request GET \
--url https://api.aireserve.com/v1/gpu/instances/{instanceId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aireserve.com/v1/gpu/instances/{instanceId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aireserve.com/v1/gpu/instances/{instanceId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"status": "requested",
"desiredState": "running",
"accelerator": {
"model": "<string>",
"count": 0
},
"runtime": {
"type": "container",
"profile": "<string>"
},
"location": {
"region": "<string>"
},
"storage": {
"rootGb": 0,
"rootPersistence": "ephemeral",
"volumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"persistent": {
"volumeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sizeGb": 0,
"mountPath": "<string>",
"usdPerHour": "<string>",
"billsUntilDeleted": true,
"survivesStop": true,
"survivesTerminate": true,
"multiAttach": false,
"status": "<string>"
}
},
"price": {
"usdPerHour": "<string>",
"storageOnlyUsdPerHour": "<string>"
},
"capabilities": {
"start": true,
"stop": true,
"restart": true,
"ssh": true,
"logs": true,
"persistentVolumes": true,
"stopPreservesRootDisk": true
},
"recovery": {
"policy": {
"mode": "none",
"maxAttempts": 5,
"cooldownMinutes": 60
},
"attempts": 0,
"maxAttempts": 0,
"lastAttemptAt": "2023-11-07T05:31:56Z",
"lastOutcome": "recovering"
},
"createdAt": "2023-11-07T05:31:56Z",
"lastError": "<string>"
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "<string>",
"details": {}
}
}Authorizations
bearerAuthapiKeyAuth
Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).
Path Parameters
Response
OK
A provider-hidden GPU instance. Provider placement identifiers are intentionally omitted.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Available options:
requested, provisioning, starting, running, stopping, stopped, terminating, terminated, reconciling, failed Available options:
running, stopped, terminated Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Health recovery state. Billing is unchanged by recovery: the resource keeps accruing while an attempt runs.
Show child attributes
Show child attributes
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$