Denvr AI Services Docs
  • Welcome to Denvr AI Services Docs!
  • OVERVIEW
    • Getting started
      • Launch a virtual machine
      • Secure Shell (SSH): Best Practices
      • API Usage samples
      • Registration
    • Data centers
    • Shared responsibility model
    • Technical support
    • What's new!
  • PLATFORM
    • Dashboard
    • Applications
    • Virtual machines
    • Bare metal
    • Storage
    • Networking
    • User management
    • Billing
  • API Reference
    • Authentication
    • Clusters
    • Applications
    • Virtual machines
    • VPCs
    • Bare metal
  • Additional Information
    • FAQs
      • Desktop vs data center GPUs
      • Differences of bare metal and virtual machines
      • GPU monitoring
      • Using Github with SSH keys
      • Data persistence and recovery
      • Do you support Kubernetes?
      • Installing GPU drivers
      • What is the network bandwidth?
      • What ports are publicly accessible?
      • What is persistent local storage?
      • Adding DAS to /etc/fstab
      • Provisioning States
    • Policies
      • Terms of Service
      • Privacy Policy
      • Acceptable Use Policy
      • Maintenance policy
Powered by GitBook
On this page
  1. API Reference

Bare metal

Explore this section for detailed information on endpoints related to the management and operation of bare metal servers within our cloud software API environment.

PreviousVPCsNextFAQs

Last updated 21 days ago

Reprovision the bare metal host

post
Body
imageUrlstring | nullableOptional

The URL to the image to use for the host

Example: https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img
imageChecksumstring | nullableOptional

The checksum url of the image to use for the host

Example: https://cloud-images.ubuntu.com/jammy/current/MD5SUMS
cloudInitBase64string | nullableOptional

Base64 encoded cloud-init data yaml file to use for the host

Example: SGVsbG8sIFdvcmxkIQ==
idstring · min: 1Required

Unique identifier for a resource within the cluster

clusterstring · min: 1Required

The cluster you're operating on

Example: Hou1
Responses
202
Accepted
400
Bad Request
401
Unauthorized
403
Forbidden
500
Server Error
post
POST /api/v1/servers/metal/ReprovisionHost HTTP/1.1
Host: 
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 234

{
  "imageUrl": "https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img",
  "imageChecksum": "https://cloud-images.ubuntu.com/jammy/current/MD5SUMS",
  "cloudInitBase64": "SGVsbG8sIFdvcmxkIQ==",
  "id": "text",
  "cluster": "Hou1"
}
{
  "id": "denvrbm-128",
  "cluster": "Msc1",
  "tenancyName": "denvr",
  "nodeType": "NVIDIA_H100_SXM5_80GB",
  "image": "jammy-server-cloudimg-amd64",
  "privateIp": "admin",
  "provisionedHostname": "text",
  "operationalStatus": "OK",
  "poweredOn": true,
  "provisioningState": "text"
}

Get detailed information about a specific metal host

get
Query parameters
IdstringRequired

Unique identifier for a resource within the cluster

ClusterstringRequired

The cluster you're operating on

Example: Hou1
Responses
200
Success
400
Bad Request
401
Unauthorized
403
Forbidden
500
Server Error
get
GET /api/v1/servers/metal/GetHost?Id=text&Cluster=Hou1 HTTP/1.1
Host: 
Accept: */*
{
  "id": "denvrbm-128",
  "cluster": "Msc1",
  "tenancyName": "denvr",
  "nodeType": "NVIDIA_H100_SXM5_80GB",
  "image": "jammy-server-cloudimg-amd64",
  "privateIp": "admin",
  "provisionedHostname": "text",
  "operationalStatus": "OK",
  "poweredOn": true,
  "provisioningState": "text"
}

Get a list of bare metal hosts in a cluster

get
Query parameters
ClusterstringOptionalExample: Hou1
Responses
200
Success
400
Bad Request
401
Unauthorized
403
Forbidden
500
Server Error
get
GET /api/v1/servers/metal/GetHosts HTTP/1.1
Host: 
Accept: */*
{
  "items": [
    {
      "id": "denvrbm-128",
      "cluster": "Msc1",
      "tenancyName": "denvr",
      "nodeType": "NVIDIA_H100_SXM5_80GB",
      "image": "jammy-server-cloudimg-amd64",
      "privateIp": "admin",
      "provisionedHostname": "text",
      "operationalStatus": "OK",
      "poweredOn": true,
      "provisioningState": "text"
    }
  ]
}
  • GETGet detailed information about a specific metal host
  • GETGet a list of bare metal hosts in a cluster
  • POSTReboot the bare metal host
  • POSTReprovision the bare metal host

Reboot the bare metal host

post
Body
idstring · min: 1Required

Unique identifier for a resource within the cluster

clusterstring · min: 1Required

The cluster you're operating on

Example: Hou1
Responses
202
Accepted
400
Bad Request
401
Unauthorized
403
Forbidden
500
Server Error
post
POST /api/v1/servers/metal/RebootHost HTTP/1.1
Host: 
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 30

{
  "id": "text",
  "cluster": "Hou1"
}
{
  "id": "denvrbm-128",
  "cluster": "Msc1",
  "tenancyName": "denvr",
  "nodeType": "NVIDIA_H100_SXM5_80GB",
  "image": "jammy-server-cloudimg-amd64",
  "privateIp": "admin",
  "provisionedHostname": "text",
  "operationalStatus": "OK",
  "poweredOn": true,
  "provisioningState": "text"
}