Start an instance

POST

https://api.hivenet.com/v1

instances

{id}

start

Start an instance

curl --request POST \
  --url https://api.hivenet.com/v1/instances/{id}/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason_note": "scaling down overnight"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({reason_note: 'scaling down overnight'})
};

fetch('https://api.hivenet.com/v1/instances/{id}/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.hivenet.com/v1/instances/{id}/start"

payload = { "reason_note": "scaling down overnight" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "instance_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "training-run-4",
  "region": "eu-west",
  "gpu_type": "RTX 4090",
  "size": "8x-RTX-4090",
  "cpu_count": 123,
  "resources": "<string>",
  "bandwidth": 123,
  "storage_used_gb": 123,
  "hourly_rate": 123,
  "current_cost": 123,
  "total_cost_incurred": 123,
  "total_runtime_hours": 123,
  "ttl_remaining_hours": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "terminated_at": "2023-11-07T05:31:56Z",
  "termination_reason": "<string>",
  "guest_ready": "<string>",
  "guest_ready_reason": "<string>"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "size must not be greater than 200",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API token",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "instance does not belong to the caller",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Instance 7f3c8f22-1f4e-4a5e-9b7a-0c1d2e3f4a5b not found",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "TOO_MANY_REQUESTS",
    "message": "Too Many Requests",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Authorizations

Authorization

string

header

required

An API key issued by Hive Compute support. See Authentication above for how to request one.

Path Parameters

string<uuid>

required

The instance's unique identifier.

Body

application/json

Optional context recorded in the audit trail for this action.

reason_note

string

Free-text note explaining why the action was taken.

Maximum string length: 10000

Example:

"scaling down overnight"

Response

The request was accepted; the instance's current state is returned.

instance_id

string<uuid>

Unique identifier.

name

string

Display name.

Example:

"training-run-4"

status

enum<string>

Current lifecycle state.

Available options:

CREATED,

DEPLOYED,

STARTING,

RUNNING,

ERRORED,

TERMINATING,

TERMINATED,

STOPPING,

STOPPED

region

string

Region the instance runs in.

Example:

"eu-west"

gpu_type

string

GPU model.

Example:

"RTX 4090"

size

string

SKU name of the preset the instance runs on.

Example:

"8x-RTX-4090"

cpu_count

integer

Virtual CPUs allocated.

resources

string

Human-readable summary of the allocated hardware.

bandwidth

number

Allocated bandwidth, in Mbps.

storage_used_gb

number

Storage currently in use, in GB.

hourly_rate

number

Price charged per hour while running, in credits.

current_cost

number

Cost accrued during the current run, in credits.

total_cost_incurred

number

Total cost over the instance's whole life, in credits.

total_runtime_hours

number

Total hours the instance has spent running.

ttl_remaining_hours

number

Hours remaining before the instance is stopped automatically.

started_at

string<date-time> | null

When the instance last entered RUNNING.

terminated_at

string<date-time> | null

When the instance was terminated, if it has been.

termination_reason

string | null

Why the instance was terminated, if it has been.

guest_ready

string

Whether the guest OS has finished booting and is reachable.

guest_ready_reason

string | null

Explanation when the guest is not ready.

⌘I

Start an instance

curl --request POST \
  --url https://api.hivenet.com/v1/instances/{id}/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason_note": "scaling down overnight"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({reason_note: 'scaling down overnight'})
};

fetch('https://api.hivenet.com/v1/instances/{id}/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.hivenet.com/v1/instances/{id}/start"

payload = { "reason_note": "scaling down overnight" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "instance_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "training-run-4",
  "region": "eu-west",
  "gpu_type": "RTX 4090",
  "size": "8x-RTX-4090",
  "cpu_count": 123,
  "resources": "<string>",
  "bandwidth": 123,
  "storage_used_gb": 123,
  "hourly_rate": 123,
  "current_cost": 123,
  "total_cost_incurred": 123,
  "total_runtime_hours": 123,
  "ttl_remaining_hours": 123,
  "started_at": "2023-11-07T05:31:56Z",
  "terminated_at": "2023-11-07T05:31:56Z",
  "termination_reason": "<string>",
  "guest_ready": "<string>",
  "guest_ready_reason": "<string>"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "size must not be greater than 200",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API token",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "instance does not belong to the caller",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Instance 7f3c8f22-1f4e-4a5e-9b7a-0c1d2e3f4a5b not found",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "TOO_MANY_REQUESTS",
    "message": "Too Many Requests",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Public API

API reference

Authorizations

Path Parameters

Body

Response