VOvoltagepark
Bare Metal

Provision a new bare-metal server rental

Deploys a bare-metal instance based on provided baremetal_config specifications and user organization. This route requires an authorization check.

An associated k8s cluster will also be created.

post/bare-metal/

Request

Headers

Idempotency-Keystring nullable

Request body

location_idstring uuid required
gpu_countinteger required
namestring required
ssh_keysstring[]

Extra SSH keys which will be added to this deploy only. To use SSH keys registered with your organization, see the organization_ssh_keys field.

network_type'infiniband' | 'ethernet' required

Machine networking: 3.2 Tbps Infiniband or 100 Gbps Ethernet

sub_orderinteger nullable

If machines are deployed with a specified sub-order, they will only have network access to other machines in the same sub-order. Not specifying a sub-order will put the machine in either the ethernet or infiniband default suborders for your account.

storage_idstring uuid nullable

If a storage volume is specified, the machine will be deployed with the storage volume attached.

tagsstring[]

Tags to add to the machine.

custom_hostnamestring nullable

Your node will use this hostname with an index appended to it. For example, my-node1

Example request

{
  "location_id": "a3111bd4-550a-47d0-838a-0a52bff2ae3f",
  "name": "My Baremetal Rental",
  "ssh_keys": [
    "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDAKOgHv82A6Oi7AWLvBC9N..."
  ],
  "network_type": "infiniband",
  "tags": [
    "tag1",
    "tag2"
  ],
  "addons": {
    "kubernetes": {
      "authentication_config_b64": "YXBpVmVyc2lvbjogYXBpc2VydmVyLmNvbmZpZy5rOHMuaW8vdjEKa2luZDogQXV0aG9yaXphdGlvbkNvbmZpZ3VyYXRpb24KYXV0aG9yaXplcnM6CiAgLSB0eXBlOiBXZWJob"
    }
  },
  "custom_hostname": "my-node"
}

Response

Successful Response

rental_idstring uuid required
warningstring nullable required

Changes

No recorded changes to this operation across all 3 revisions of this API.