h3llo cloudDOCS

Список виртуалок

GET
/instances

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (h3pat_...) или access-token из OIDC exchange.

In: header

Query Parameters

project*string

ID проекта

status?string
Value in"pending" | "running" | "stopped" | "deleting" | "error"
limit?integer

Сколько элементов вернуть (1–200, default 50)

Default50
Range1 <= value <= 200
cursor?string

Курсор из предыдущего ответа (next_cursor)

Response Body

application/json

application/problem+json

curl -X GET "https://api.h3llo.cloud/v1/instances?project=string"
{
  "items": [
    {
      "id": "i-7f9a2c01",
      "name": "web-01",
      "status": "running",
      "flavor": "m1.medium",
      "image": "ubuntu-24.04",
      "network": {
        "public_ipv4": "89.20.10.42",
        "private_ipv4": "10.0.0.4"
      },
      "created_at": "2026-04-18T09:11:02.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "code": "string",
  "trace_id": "string"
}