Создать облачный диск

Создает новый сетевой диск (S3-бакет/папку). Этот диск может быть примонтирован к вашим GPU-инстансам. При превышении квоты размер диска и стоимость будут автоматически пересчитаны.

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

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

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

Параметры тела (Body)

Параметр

Тип

Описание

name*

string

Понятное имя для вашего облачного диска (например, 'SDXL Datasets').

size_gb*

number

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

Примеры кода

curl -X POST "https://api.yougpu.ru/storage/drives" \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SDXL Datasets",
    "size_gb": 50
  }'

import requests

url = "https://api.yougpu.ru/storage/drives"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>",
    "Content-Type": "application/json"
}
data = {
    "name": "SDXL Datasets",
    "size_gb": 50
}

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

const response = await fetch('https://api.yougpu.ru/storage/drives', {
  "method": "POST",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>",
      "Content-Type": "application/json"
  },
  "body": JSON.stringify({
      "name": "SDXL Datasets",
      "size_gb": 50
  })
});
const data = await response.json();
console.log(data);

Ответы

201 Created

{
  "status": "success",
  "code": 201,
  "data": {
    "id": "717fdac6-51db-4272-a6e3-d1a4f89cdc5f",
    "name": "SDXL Datasets",
    "size_gb": 50,
    "s3_path": "91473dbe-62c4-49c6-bb10-8fd7853af801/c012f5cf-dcd2-40be-9139-62c1d7a0ea63/",
    "status": "AVAILABLE",
    "used_bytes": "0",
    "price_per_hour": "0.5",
    "last_billed_at": "2026-03-09T10:15:30.000Z",
    "paid_until": "2026-03-09T11:15:30.000Z",
    "current_instance_id": null,
    "created_at": "2026-03-09T10:15:30.000Z",
    "updated_at": "2026-03-09T10:15:30.000Z"
  }
}

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

Параметр

Тип

Описание

status

string

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

code

number

HTTP код ответа.

data

object

Данные созданного диска:

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.

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

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

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