# Квоты и потребление

У файлового хранилища аккаунта есть отдельные лимиты байтов и объектов. Получайте текущие значения для активного аккаунта из API:

```
curl --fail-with-body --silent --show-error \
  "$JUSTRUN_API/v1/storage/usage" \
  --header "Authorization: Bearer $JUSTRUN_PAT" |
  jq '{bytes_used, pending_bytes, object_count, pending_objects,
       quota_bytes, quota_objects, unknown_writers, legacy_byte_limit,
       available_bytes: ([.quota_bytes-.bytes_used-.pending_bytes,0]|max),
       reconciled_at}'
```

Рост должен укладываться в каждый затронутый лимит. Заполнить лимит ровно допустимо. Новый пустой объект тоже занимает один слот.

```
bytes_used + pending_bytes + positive_size_difference <= quota_bytes
object_count + pending_objects + new_object_slot <= quota_objects
```

## Поля потребления[​](#usage-fields "Прямая ссылка на Поля потребления")

| Поле                           | Значение                                                                         |
| ------------------------------ | -------------------------------------------------------------------------------- |
| `bytes_used`                   | Байты сохраненных объектов, обновляемые операциями шлюза и сверкой               |
| `pending_bytes`                | Резерв положительного роста, включая публикации с неизвестным результатом        |
| `object_count`                 | Число сохраненных объектов                                                       |
| `pending_objects`              | Резерв новых объектов, в том числе пустых                                        |
| `quota_bytes`, `quota_objects` | Действующие лимиты аккаунта                                                      |
| `unknown_writers`              | У старой операции нет известного резерва; рост требует восстановления оператором |
| `legacy_byte_limit`            | Байтовый лимит получен из прежней политики в ГиБ                                 |
| `reconciled_at`                | Последняя успешная полная сверка или `null`                                      |

Карточка хранилища включает зарезервированные байты в шкалу потребления, показывает резерв объектов отдельно и предупреждает о превышении лимита. Редактор политики аккаунта в админке показывает то же потребление и позволяет менять лимиты без перезапуска сервиса.

Лимиты относятся только к пользовательским файлам хранилища. Диски песочниц и версии собственных шаблонов ограничиваются отдельно. В каждом слое политики точные байты важнее прежнего значения в ГиБ. Индивидуальные ограничения важнее тарифа: поэтому индивидуальный лимит в ГиБ тоже важнее байтового лимита тарифа. Значение в ГиБ умножается на `1073741824`; `legacy_byte_limit` показывает выбранный формат. Ноль означает явный лимит, а не наследование.

## Запись и резервы[​](#writes-and-reservations "Прямая ссылка на Запись и резервы")

| Операция                                   | Допуск и учет                                                           |
| ------------------------------------------ | ----------------------------------------------------------------------- |
| PUT нового ключа                           | Резерв всего размера и одного слота объектов                            |
| Перезапись через шлюз или по presigned URL | Резерв только положительного роста байтов, без нового слота             |
| Перезапись тем же или меньшим размером     | Доступна после понижения лимита или отзыва права записи                 |
| Удаление                                   | Снимает измеренные байты и один объект; доступно после понижения тарифа |
| GET, HEAD, presigned GET                   | Не расходует дополнительную квоту байтов или объектов                   |

Шлюз последовательно допускает резервы в PostgreSQL. Учет опубликованного объекта и снятие резерва коммитятся вместе. Гарантия требует, чтобы все пишущие клиенты пользовались этим протоколом; прямые записи в бакет в нее не входят.

Ключом владеет только одна активная запись или сессия загрузки. Повторный PUT, DELETE или запрос presigned URL для того же ключа получает `409 storage.operation_in_progress`; чтение остается доступным. Для повтора передачи используйте исходные идентификатор загрузки и URL. Разные ключи можно записывать параллельно в пределах бюджета аккаунта.

Уже допущенная загрузка может завершиться после понижения лимита или отзыва права; действующие учетные данные с доступом записи все равно обязательны. Новый объект или рост без права записи в инсталляции, проверяющей это право, может получить `404 feature.not_enabled`.

## Отмена и истечение загрузки[​](#cancel-or-expire-an-upload "Прямая ссылка на Отмена и истечение загрузки")

Presigned URL загружает неопубликованные части. Публиковать может только авторизованный вызов завершения. Резерв незавершенной загрузки действует до `complete_before`, на 300 секунд дольше `expires_at` URL.

Чтобы сразу освободить неиспользуемую незавершенную сессию:

```
curl --fail-with-body --silent --show-error \
  --request DELETE "$JUSTRUN_API/v1/storage/uploads/$UPLOAD_ID" \
  --header "Authorization: Bearer $JUSTRUN_PAT"
```

Отмена возвращает `204`, в том числе для уже отмененной сессии. Отмененная или истекшая незавершенная сессия больше не публикует; части удаляются асинхронно. Отмена опубликованной сессии возвращает `409`: удалите ее объект. Если публикация уже началась и результат неизвестен, отмена отвечает `503` и сохраняет резерв.

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

## Сверка и восстановление[​](#reconciliation-and-recovery "Прямая ссылка на Сверка и восстановление")

Регулярная сверка читает полный список бакета. Ошибка любой страницы не дает опубликовать частичные итоги. Аккаунты с незавершенными пишущими клиентами не получают подтвержденные итоги и освобождение резерва автоматически. Оператор должен закрыть новые изменения, дождаться завершения работы пишущих клиентов и сверить полный список. Интервал зависит от инсталляции; `reconciled_at: null` не доказывает пустой бакет.

При `429 quota.exceeded` проверяйте байты и слоты объектов вместе с резервами. Удалите ненужные файлы, уменьшите существующие или отмените незавершенную сессию. После понижения тарифа файлы доступны для чтения и удаления, а рост ждет свободного бюджета. После неопределенного `503` сохраните локальный источник и идентификатор загрузки и обратитесь к оператору.

| Ситуация                                | Действие                                                                                           |
| --------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Байты свободны, но приходит `429`       | Проверьте `object_count + pending_objects` относительно `quota_objects`                            |
| `409 storage.operation_in_progress`     | Продолжите, завершите или отмените исходную загрузку; неопределенная запись требует восстановления |
| `unknown_writers: true`                 | Попросите оператора остановить старые пишущие клиенты и провести сверку                            |
| Резерв пережил URL                      | Проверьте `complete_before`; неизвестный результат публикации остается зарезервированным           |
| Все маршруты хранилища возвращают `404` | Хранилище может быть выключено в инсталляции                                                       |

## Связанные разделы[​](#related "Прямая ссылка на Связанные разделы")

* [Загрузка и скачивание](/storage/upload-and-download.md)
* [Объекты и ключи](/storage/objects-and-keys.md)
* [Доступ к хранилищу из песочницы](/storage/access-from-sandboxes.md)
* [Безопасность и жизненный цикл данных](/storage/security-and-data-lifecycle.md)
* [REST API](/api-reference/rest.md)
