Skip to content

Get Host

GET
/v1/armada/host/{host_id}

Get a host

Authorizations

Parameters

Path Parameters

host_id
required

The host ID

string format: uuid

The host ID

Responses

200

Successful Response

A representation of a host that can be used to deploy a product to. Can be physical, virtual, or a container.

object
internal_hostname

The internal hostname of the host. Should only be addressable internally.

string
>= 1 characters <= 253 characters
public_hostname

The public hostname of the host. Should be addressable from the internet.

string
>= 1 characters <= 253 characters
internal_ipv4

The internal IPv4 address of the host. Should only be addressable internally.

string format: ipv4
public_ipv4

The public IPv4 address of the host. Should be addressable from the internet.

string format: ipv4
internal_ipv6

The internal IPv6 address of the host. Should only be addressable internally.

string
>= 1 characters <= 128 characters
public_ipv6

The public IPv6 address of the host. Should be addressable from the internet.

string
>= 1 characters <= 128 characters
geographic_location

The geographic location of the host

object
description
required

Where exactly is this in the physical world.

string
>= 1 characters
geographic_location_id
required
string format: uuid
datacenter_provider

The datacenter provider of the host

object
name
required

Name of the provider of this sort. Could be things like Amazon, AWS EC2, Internap.

string
>= 1 characters <= 64 characters
datacenter_provider_id
required
string format: uuid
datacenter_location

The datacenter location of the host

object
description
required

Which datacenter region this is in using the language of the provider. Could be things like us-east-1, us-west-2, etc.

string
>= 1 characters
datacenter_location_id
required
string format: uuid
machine_class

The machine class of the host

object
datacenter_provider
required

The provider this machine class is associated with

object
name
required

Name of the provider of this sort. Could be things like Amazon, AWS EC2, Internap.

string
>= 1 characters <= 64 characters
datacenter_provider_id
required
string format: uuid
name
required

The name of the machine class used by the provider

string
>= 1 characters <= 64 characters
type
required

The type of machine class used by the provider. General Purpose, CPU Optimized, etc.

string
>= 1 characters <= 64 characters
labels

Labels that can be applied to the machine class for organizational purposes

Array<string>
monthly_price

The monthly price of this machine class

number
hourly_price

The hourly price of this machine class

number
cpu_count

The number of CPUs

integer
cpu_info

A description of the CPU including type, family, model, and stepping

string
>= 1 characters
cpu_type

The short description of the CPU type. e.g. Intel Xeon E5-2673 v4 @ 2.30GHz

string
>= 1 characters <= 64 characters
cpu_sockets

The number of populated CPU sockets

integer
cpu_cores

The number of CPU cores

integer
cpu_threads

The number of CPU threads. Will be more than cores if hyperthreading is enabled.

integer
memory_size_gigabytes

The amount of memory in gigabytes

integer
memory_type

The type of memory. e.g. DDR4

string
>= 1 characters <= 32 characters
memory_speed_rating

The speed rating of the memory in MHz

integer
memory_timings

The memory timings. e.g. 15-15-15-36

string
>= 1 characters <= 32 characters
disk_type

The type of disk. e.g. SSD

string
>= 1 characters <= 64 characters
disk_size_gigabytes

The size of the disk in gigabytes

integer
disk_sequential_read

The sequential read speed of the disk

string
>= 1 characters <= 64 characters
disk_sequential_write

The sequential write speed of the disk

string
>= 1 characters <= 64 characters
disk_random_read

The random read speed of the disk

string
>= 1 characters <= 64 characters
disk_random_write

The random write speed of the disk

string
>= 1 characters <= 64 characters
disk_iops

The number of IOPS the disk can handle

integer
disk_latency_ms

The latency of the disk in milliseconds

integer
network_gbps

The network speed in gigabits per second

integer
gpu_type

The type of GPU. e.g. NVIDIA Tesla V100

string
>= 1 characters <= 64 characters
gpu_count

The number of GPUs

integer
gpu_memory_gigabytes

The amount of GPU memory in gigabytes. Should be the lowest available memory if there are multiple GPUs.

integer
machine_class_id
required
string format: uuid
machine_class_overrides

A machine class bespoke to this host used for overriding any values of the machine class that are not true for this host. There may be a different pricing model, or the machine is simply known to be a crappier version of the CPU offered by the machineclass.

object
datacenter_provider
required

The provider this machine class is associated with

object
name
required

Name of the provider of this sort. Could be things like Amazon, AWS EC2, Internap.

string
>= 1 characters <= 64 characters
datacenter_provider_id
required
string format: uuid
name
required

The name of the machine class used by the provider

string
>= 1 characters <= 64 characters
type
required

The type of machine class used by the provider. General Purpose, CPU Optimized, etc.

string
>= 1 characters <= 64 characters
labels

Labels that can be applied to the machine class for organizational purposes

Array<string>
monthly_price

The monthly price of this machine class

number
hourly_price

The hourly price of this machine class

number
cpu_count

The number of CPUs

integer
cpu_info

A description of the CPU including type, family, model, and stepping

string
>= 1 characters
cpu_type

The short description of the CPU type. e.g. Intel Xeon E5-2673 v4 @ 2.30GHz

string
>= 1 characters <= 64 characters
cpu_sockets

The number of populated CPU sockets

integer
cpu_cores

The number of CPU cores

integer
cpu_threads

The number of CPU threads. Will be more than cores if hyperthreading is enabled.

integer
memory_size_gigabytes

The amount of memory in gigabytes

integer
memory_type

The type of memory. e.g. DDR4

string
>= 1 characters <= 32 characters
memory_speed_rating

The speed rating of the memory in MHz

integer
memory_timings

The memory timings. e.g. 15-15-15-36

string
>= 1 characters <= 32 characters
disk_type

The type of disk. e.g. SSD

string
>= 1 characters <= 64 characters
disk_size_gigabytes

The size of the disk in gigabytes

integer
disk_sequential_read

The sequential read speed of the disk

string
>= 1 characters <= 64 characters
disk_sequential_write

The sequential write speed of the disk

string
>= 1 characters <= 64 characters
disk_random_read

The random read speed of the disk

string
>= 1 characters <= 64 characters
disk_random_write

The random write speed of the disk

string
>= 1 characters <= 64 characters
disk_iops

The number of IOPS the disk can handle

integer
disk_latency_ms

The latency of the disk in milliseconds

integer
network_gbps

The network speed in gigabits per second

integer
gpu_type

The type of GPU. e.g. NVIDIA Tesla V100

string
>= 1 characters <= 64 characters
gpu_count

The number of GPUs

integer
gpu_memory_gigabytes

The amount of GPU memory in gigabytes. Should be the lowest available memory if there are multiple GPUs.

integer
machine_class_id
required
string format: uuid
machine_image

The machine image of the host

object
name
required

The name within the context of the provider. This could be a registry path or an AWS image name.

string
>= 1 characters <= 256 characters
description

A long form description of the image that will only be used for documentation purposes

string
machine_image_id
required
string format: uuid
monthly_price

The monthly price of this host. If set, this value will supersede any monthly_price value set by the machine_class or contract

number
hourly_price

The hourly price of this host. If set, this value will supersede any hourly_price value set by the machine_class or contract

number
notes

Notes about the host. Used for extra information that doesn’t fit in other fields.

string
labels

Labels that can be applied to the host for organizational purposes

Array<string>
datacenter_contract

The contract this host is associated with

object
start_date

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string format: date-time
end_date

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string format: date-time
cancel_date

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string format: date-time
period_days

The number of days in the contract period

integer
extend_period_days

The service extend period in days

integer
notice_days

The number of days notice required to cancel the contract

integer
purchase_order

The purchase order number or description for the contract

string
>= 1 characters
payment_term_days

The number of days after the invoice is sent that payment is due

integer
hosts

The IDs of the hosts this contract is associated with

Array<string>
datacenter_contract_id
required
string format: uuid
prior_host_id

The ID of the host this host replaced

string format: uuid
host_id
required
string format: uuid
simple_product_assignments

Assignments for this host

Array<object>

This is a minimal assignment type that represents how we currently handle assignments, but should be improved upon in the future.

object
name
required

The name of the product that will be used directly by the deployment system. e.g., paladins, roco

string
>= 1 characters <= 256 characters
count
required

The number of instances of the product that will be used directly by the deployment system.

integer
host_id
required

The ID of the host this assignment is associated with

string format: uuid
simple_product_assignment_id
required
string format: uuid

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string