Запустить инстанс

Инициирует запуск остановленного сервера. Переводит статус из `STOPPED` в `STARTING`. Метод моментально резервирует средства за следующий час аренды.

POST https://api.yougpu.ru/instances/{id}/start

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

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

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

Параметр

Тип

Описание

id*

string

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

Примеры кода

curl -X POST "https://api.yougpu.ru/instances/e3b0c442-989b-464c-8693-e1d5a7d65b32/start" \
  -H "X-API-KEY: <YOUR_API_KEY>"

import requests

url = "https://api.yougpu.ru/instances/e3b0c442-989b-464c-8693-e1d5a7d65b32/start"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>"
}

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

const response = await fetch('https://api.yougpu.ru/instances/e3b0c442-989b-464c-8693-e1d5a7d65b32/start', {
  "method": "POST",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>"
  }
});
const data = await response.json();
console.log(data);

Ответ

200 OK

{
  "status": "success",
  "code": 200,
  "data": {
    "status": "STARTING",
    "paid_until": "2026-02-05T22:30:00.000Z"
  }
}

400 Bad Request

Возникает, если инстанс уже работает, не находится в статусе STOPPED или на балансе недостаточно средств.

{
  "statusCode": 400,
  "message": "Cannot start instance with status ACTIVE",
  "error": "Bad Request"
}

409 Conflict

Возникает, если на балансе недостаточно средств для резервирования оплаты за следующий час.

{
  "statusCode": 409,
  "message": "Insufficient funds to start the instance",
  "error": "Conflict"
}

500 Internal Server Error

Возникает, если провайдер не смог обработать запрос на запуск. В этом случае средства возвращаются на баланс.

{
  "statusCode": 500,
  "message": "Failed to start instance on provider side. Funds refunded.",
  "error": "Internal Server Error"
}

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

Параметр

Тип

Описание

status

string

Статус выполнения запроса.

code

number

HTTP код ответа.

data

object

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

status

InstanceStatus

Текущий статус:

CREATING

Value

0. Запись создана в БД, процесс инициализации.

PROVISIONING

Value

1. Запрос отправлен провайдеру, ожидаем выделения железа.

INSTALLING

Value

2. Идёт установка выбранного шаблона(Jupyter, ComfyUI). Сервер работает, SSH доступен.

ACTIVE

Value

3. Сервер работает, SSH доступен.

STOPPING

Value

4. Процесс остановки (Graceful shutdown).

STOPPED

Value

5. Выключен. Диск занят, данные сохранены.

STARTING

Value

6. Запуск ранее остановленного сервера.

REBOOTING

Value

7. Перезагрузка по команде пользователя.

TERMINATING

Value

8. Процесс безвозвратного удаления.

TERMINATED

Value

9. Сервер удален (Soft Delete).

ERROR

Value

Ошибка на стороне провайдера.

paid_until

string

Дата и время, до которого оплачена аренда (обычно текущее время + 1 час).

Есть вопросы?

Поддержка Чат

Нашли ошибку? Сообщить