Логи событий

Возвращает хронологию событий инстанса: создание, изменение статусов, ошибки провайдера и действия пользователя. Результат отсортирован от новых событий к старым.

GET https://api.yougpu.ru/instances/{id}/events

Заголовки (Headers)

Заголовок	Значение	Описание
X-API-KEY	<YOUR_API_KEY>	Ваш API ключ
Content-Type	application/json	Формат данных

Параметры пути (Path)

Параметр

Тип

Описание

id*

string

Уникальный UUID инстанса.

Параметры запроса (Query)

Параметр

Тип

Описание

page

number

Номер страницы (по умолчанию 1).

limit

number

Количество записей на странице (по умолчанию 10).

Примеры кода

curl -X GET "https://api.yougpu.ru/instances/inst_01HGP.../events?page=1&limit=5" \
  -H "X-API-KEY: <YOUR_API_KEY>"

import requests

url = "https://api.yougpu.ru/instances/inst_01HGP.../events?page=1&limit=5"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://api.yougpu.ru/instances/inst_01HGP.../events?page=1&limit=5', {
  "method": "GET",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>"
  }
});
const data = await response.json();
console.log(data);

Ответ

200 OK

{
  "status": "success",
  "code": 200,
  "data": [
    {
      "id": "e3b0c442-989b-464c-8693-e1d5a7d65b32",
      "instance_id": "e3b0c442-989b-464c-8693-e1d5a7d65b32",
      "type": "STATUS_CHANGE",
      "message": "Status changed to ACTIVE",
      "payload": { "ip": "203.0.113.10" },
      "created_at": "2026-02-05T10:05:00Z"
    },
    {
      "id": "e3b0c442-989b-464c-8693-e1d5a7d65b32",
      "instance_id": "e3b0c442-989b-464c-8693-e1d5a7d65b32",
      "type": "INFO",
      "message": "Instance created",
      "payload": null,
      "created_at": "2026-02-05T10:00:00Z"
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "limit": 5,
    "total_pages": 1
  }
}

404 Not Found

{
  "statusCode": 404,
  "message": "Instance not found",
  "error": "Not Found"
}

Структура ответа

Параметр

Тип

Описание

status

string

Статус выполнения запроса (например, success).

code

number

HTTP код ответа.

data

array

Данные ответа:

string

ID события.

instance_id

string

ID инстанса.

type

InstanceEventType

Категория события:

INFO

Enum

Информационные сообщения (загрузка SSH ключей, отправка запросов).

WARNING

Enum

Некритичные проблемы (повторные попытки, задержки ответа).

ERROR

Enum

Ошибки (сбой провайдера, отказ в доступе).

STATUS_CHANGE

Enum

Изменение жизненного цикла (Creating → Active, Stopping → Stopped).

BILLING

Enum

Финансовые операции (резервирование средств, списание, возврат).

message

string

Человекочитаемое описание события.

payload

json | null

Дополнительные технические данные (например, выделенный IP или код ошибки провайдера).

created_at

string

Дата и время возникновения события.