v1

latestOpenAPI 3.0.02026-07-26258182277.4 KB
Bare Metal Devices

Update/reload instant device

put/bare-metal-devices/{deviceId}

Query parameters

skipPowerCheckboolean

If true, bypass the powered off check.

Headers

X-Fieldsstring mask

An optional fields mask

Request body

appNamestring

The name of the application to provision on this device. Must match the name field of an application

appUserDataobject

User data for specific application if reloading using app option

customIPXEScriptContentsstring

Contents of iPXE script if not specifying URL. If both script URL and contents are not specified, the last iPXE script contents are used if OS selection requires an iPXE script.

customIPXEScriptURLstring

URL to download custom iPXE script if not specifying contents in entirety. If both script URL and contents are not specified, the last iPXE script contents are used if OS selection requires an iPXE script.

forceReloadboolean

Whether to force a reload even if fields have not changed

hostnamestring required

A FQDN for the device. For example: example.hivelocity.net

ignitionIdinteger

The unique ID of an Ignition File for FlatcarOS provisions.

osNamestring

The name of the Operating System to provision on this device. Must match name of an operating system product option.

publicSshKeyIdinteger
scriptstring

A Cloud-Init script or a post-install script (Bash for Linux or Powershell for Windows).

tagsstring[]

Response

Device updated.

appNamestring

If device was deployed with as an application, this is the name of the application used.

customIPXEScriptContentsstring

Contents of custom iPXE used to provision device

customIPXEScriptURLstring

URL of custom iPXE script used to provision device

deviceIdinteger

The unique ID of the device.

hostnamestring

The user specified hostname for the device. Note: If the hostname is changed in the portal or on the device itself this value may not reflect the actual hostname on the device.

locationNamestring

A facility code. For example NYC1.

orderIdinteger

The unique ID of the order for this device.

osNamestring

The name of the operating system currently installed on this device. Note: If you manually reload your own OS over IPMI this value may not reflect the OS currently on your device.

periodstring

This device's service's billing period.

powerStatusstring

ON|OFF

primaryIpstring

The first assigned public IP for accessing this device.

productIdinteger

The unique ID of the product associated with this device.

productNamestring

The name of the product associated with this device.

publicSshKeyIdinteger
scriptstring

The post-install/cloud-init script used during this device's last provisioning.

serviceIdinteger

The unique ID of the service associated with this device.

tagsstring[]

User specified values.

vlanIdinteger

Example response

{
  "period": "hourly"
}