Удалить инстанс

Инициирует полное уничтожение виртуальной машины. Останавливает все списания средств и возвращает на баланс неиспользованный остаток зарезервированных средств за текущий час.

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

Заголовки (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/terminate" \
  -H "X-API-KEY: <YOUR_API_KEY>"

import requests

url = "https://api.yougpu.ru/instances/e3b0c442-989b-464c-8693-e1d5a7d65b32/terminate"
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/terminate', {
  "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": "TERMINATING",
  }
}

400 Bad Request

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

{
  "statusCode": 400,
  "message": "Instance is already terminated or terminating",
  "error": "Bad Request"
}

500 Internal Server Error

Возникает при ошибках на стороне провайдера. Если системе не удалось удалить сервер физически, статус в базе данных будет откатан назад, чтобы вы могли повторить попытку позже.

{
  "statusCode": 500,
  "message": "Provider error: Could not terminate instance.",
  "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

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

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

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

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