Список облачных дисков

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

GET https://api.yougpu.ru/storage/drives

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

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

Подключенные диски

Если диск в данный момент примонтирован к запущенному серверу, в поле current_instance_id будет указан идентификатор этого сервера.

Примеры кода

cURL

curl -X GET "https://api.yougpu.ru/storage/drives" \
  -H "X-API-KEY: <YOUR_API_KEY>"

Python

import requests

url = "https://api.yougpu.ru/storage/drives"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>"
}

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

Node.js

const response = await fetch('https://api.yougpu.ru/storage/drives', {
  "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": "717fdac6-51db-4272-a6e3-d1a4f89cdc5f",
      "name": "SDXL Datasets",
      "size_gb": 50,
      "s3_path": "91473dbe-62c4-49c6-bb10-8fd7853af801/717fdac6-51db-4272-a6e3-d1a4f89cdc5f/",
      "status": "AVAILABLE",
      "used_bytes": "10737418240",
      "price_per_hour": "1.50",
      "last_billed_at": "2026-03-09T10:15:30.000Z",
      "paid_until": null,
      "current_instance_id": "abcfdac6-51db-4272-a6e3-d1a4f89cdc5f",
      "created_at": "2026-03-09T10:15:30.000Z",
      "updated_at": "2026-03-09T10:15:30.000Z"
    },
    {
      "id": "717fdac6-51db-4272-a6e3-d1a4f89cdc5f",
      "name": "Models Backup",
      "size_gb": 100,
      "s3_path": "91473dbe-62c4-49c6-bb10-8fd7853af801/717fdac6-51db-4272-a6e3-d1a4f89cdc5f/",
      "status": "AVAILABLE",
      "used_bytes": "0",
      "price_per_hour": "3.00",
      "last_billed_at": "2026-03-09T11:00:00.000Z",
      "paid_until": null,
      "current_instance_id": null,
      "created_at": "2026-03-09T11:00:00.000Z",
      "updated_at": "2026-03-09T11:00:00.000Z"
    }
  ]
}

---

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

Параметр

Тип

Описание

status

string

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

code

number

HTTP код ответа.

data

array

Массив объектов с данными облачных дисков:

id

string

Уникальный идентификатор диска.

name

string

Имя диска, указанное при создании.

size_gb

number

Текущий тарифицируемый лимит диска в гигабайтах.

s3_path

string

Внутренний префикс (путь) в S3 бакете.

status

DriveStatus

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

AVAILABLE

Value

Свободен, можно подключать к новому инстансу.

IN_USE

Value

Физически примонтирован к серверу, идет работа.

SYNCING

Value

В процессе загрузки (pull) или выгрузки (push) файлов в/из S3.

DELETING

Value

В процессе удаления.

DELETED

Value

Диск удалён.

SUSPENDED

Value

Баланс исчерпан, диск заморожен. Задолженность за время заморозки накапливается и будет списана при пополнении баланса. Через 7 дней диск удаляется безвозвратно.

ERROR

Value

Произошла ошибка (например, не хватило места или S3 недоступен).

used_bytes

string

Фактически занятое место в байтах.

price_per_hour

string

Текущая стоимость диска в час.

last_billed_at

string

Дата последнего списания средств за этот диск в формате ISO 8601.

paid_until

string | null

Дата, до которой диск оплачен в формате ISO 8601.

current_instance_id

string | null

Идентификатор инстанса, к которому в данный момент подключен диск (null, если диск свободен).

created_at

string

Дата создания диска в формате ISO 8601.

updated_at

string

Дата последнего обновления в формате ISO 8601.

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

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

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