Обновить диск

Обновляет параметры существующего облачного диска. Вы можете переименовать диск или изменить его базовый тарифицируемый размер (лимит). При изменении размера стоимость диска будет автоматически пересчитана.

PATCH https://api.yougpu.ru/storage/drives/{id}

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

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

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

Параметр

Тип

Описание

id*

string

Уникальный идентификатор обновляемого облачного диска (например, 'drive_01HQK...').

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

Параметр

Тип

Описание

name*

string

Новое имя для вашего облачного диска.

size_gb*

number

Новый базовый размер диска в гигабайтах.

Примеры кода

curl -X PATCH "https://api.yougpu.ru/storage/drives/717fdac6-51db-4272-a6e3-d1a4f89cdc5f" \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SDXL Datasets (Updated)",
    "size_gb": 100
  }'

import requests

url = "https://api.yougpu.ru/storage/drives/717fdac6-51db-4272-a6e3-d1a4f89cdc5f"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>",
    "Content-Type": "application/json"
}
data = {
    "name": "SDXL Datasets (Updated)",
    "size_gb": 100
}

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

const response = await fetch('https://api.yougpu.ru/storage/drives/717fdac6-51db-4272-a6e3-d1a4f89cdc5f', {
  "method": "PATCH",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>",
      "Content-Type": "application/json"
  },
  "body": JSON.stringify({
      "name": "SDXL Datasets (Updated)",
      "size_gb": 100
  })
});
const data = await response.json();
console.log(data);

Ответы

200 OK

{
  "status": "success",
  "code": 200,
  "data": {
    "id": "717fdac6-51db-4272-a6e3-d1a4f89cdc5f",
    "name": "SDXL Datasets (Updated)",
    "size_gb": 100,
    "s3_path": "91473dbe-62c4-49c6-bb10-8fd7853af801/717fdac6-51db-4272-a6e3-d1a4f89cdc5f",
    "status": "AVAILABLE",
    "used_bytes": "10737418240",
    "price_per_hour": "3.00",
    "last_billed_at": "2026-03-09T10:15:30.000Z",
    "paid_until": null,
    "current_instance_id": null,
    "created_at": "2026-03-09T10:15:30.000Z",
    "updated_at": "2026-03-09T12:45:00.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.

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

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

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