Machines
curl --request GET \
--url https://levers9.uselevers.com/machines \
--header 'Authorization: Bearer <token>'import requests
url = "https://levers9.uselevers.com/machines"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://levers9.uselevers.com/machines', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://levers9.uselevers.com/machines",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://levers9.uselevers.com/machines"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://levers9.uselevers.com/machines")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://levers9.uselevers.com/machines")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"ok": true,
"errMsg": "<string>",
"machines": [
{
"id": "<string>",
"cpu": "<string>",
"memory": "<string>",
"gpu": "<string>",
"gpuCount": 123,
"status": "<string>",
"poolName": "<string>",
"providerName": "<string>",
"registrationToken": "<string>",
"tailscaleUrl": "<string>",
"tailscaleAuth": "<string>",
"lastKeepalive": "<string>",
"created": "<string>",
"machineVersion": "<string>",
"machineMetrics": {
"totalCpuAvailable": 123,
"totalMemoryAvailable": 123,
"cpuUtilizationPct": 123,
"memoryUtilizationPct": 123,
"workerCount": 123,
"containerCount": 123,
"freeGpuCount": 123,
"cacheUsagePct": 123,
"cacheCapacity": 123,
"cacheMemoryUsage": 123,
"cacheCpuUsage": 123,
"memoryUsedMb": "<string>",
"memoryTotalMb": "<string>",
"diskUsedMb": "<string>",
"diskTotalMb": "<string>",
"diskUsagePct": 123,
"pathMetrics": [
{
"label": "<string>",
"path": "<string>",
"usedMb": "<string>",
"totalMb": "<string>",
"availableMb": "<string>",
"usagePct": 123
}
]
},
"userData": "<string>",
"ssh": {
"supported": true,
"status": "<string>",
"publicIp": "<string>",
"host": "<string>",
"port": 123,
"username": "<string>",
"activeGeneration": "<string>",
"appliedGeneration": "<string>",
"keyFingerprint": "<string>",
"hostKeyFingerprint": "<string>",
"privateKeyAvailable": true,
"pendingRotation": true,
"pendingGeneration": "<string>",
"pendingFingerprint": "<string>",
"pendingKeyAvailable": true,
"pendingKeyDownloaded": true,
"error": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"gpus": {},
"supportedGpus": {},
"maxCpuMillicores": 123,
"maxMemoryMb": 123,
"nodeCapacity": {}
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}ControlPlaneService
Machines
GET
/
machines
Machines
curl --request GET \
--url https://levers9.uselevers.com/machines \
--header 'Authorization: Bearer <token>'import requests
url = "https://levers9.uselevers.com/machines"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://levers9.uselevers.com/machines', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://levers9.uselevers.com/machines",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://levers9.uselevers.com/machines"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://levers9.uselevers.com/machines")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://levers9.uselevers.com/machines")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"ok": true,
"errMsg": "<string>",
"machines": [
{
"id": "<string>",
"cpu": "<string>",
"memory": "<string>",
"gpu": "<string>",
"gpuCount": 123,
"status": "<string>",
"poolName": "<string>",
"providerName": "<string>",
"registrationToken": "<string>",
"tailscaleUrl": "<string>",
"tailscaleAuth": "<string>",
"lastKeepalive": "<string>",
"created": "<string>",
"machineVersion": "<string>",
"machineMetrics": {
"totalCpuAvailable": 123,
"totalMemoryAvailable": 123,
"cpuUtilizationPct": 123,
"memoryUtilizationPct": 123,
"workerCount": 123,
"containerCount": 123,
"freeGpuCount": 123,
"cacheUsagePct": 123,
"cacheCapacity": 123,
"cacheMemoryUsage": 123,
"cacheCpuUsage": 123,
"memoryUsedMb": "<string>",
"memoryTotalMb": "<string>",
"diskUsedMb": "<string>",
"diskTotalMb": "<string>",
"diskUsagePct": 123,
"pathMetrics": [
{
"label": "<string>",
"path": "<string>",
"usedMb": "<string>",
"totalMb": "<string>",
"availableMb": "<string>",
"usagePct": 123
}
]
},
"userData": "<string>",
"ssh": {
"supported": true,
"status": "<string>",
"publicIp": "<string>",
"host": "<string>",
"port": 123,
"username": "<string>",
"activeGeneration": "<string>",
"appliedGeneration": "<string>",
"keyFingerprint": "<string>",
"hostKeyFingerprint": "<string>",
"privateKeyAvailable": true,
"pendingRotation": true,
"pendingGeneration": "<string>",
"pendingFingerprint": "<string>",
"pendingKeyAvailable": true,
"pendingKeyDownloaded": true,
"error": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"gpus": {},
"supportedGpus": {},
"maxCpuMillicores": 123,
"maxMemoryMb": 123,
"nodeCapacity": {}
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
A successful response.
Show child attributes
Show child attributes
gpus reports live worker availability per GPU type (a worker with that GPU is currently registered).
Show child attributes
Show child attributes
supported_gpus reports pool-config-based serverless support per GPU type: true when a pool could serve the GPU even if scaled to zero.
Show child attributes
Show child attributes
Resource ceilings enforced when creating a serverless stub. Private on-demand pools own their machine and do not use these limits.
node_capacity reports cluster nodes that could host a worker for each GPU type right now. A ready node is capacity nobody has claimed yet, which is not the same thing as a worker running on it: with a node up the first task waits only for a pod to start, without one it waits for a node too.
Show child attributes
Show child attributes