Квоты и потребление
У файлового хранилища аккаунта есть отдельные лимиты байтов и объектов. Получайте текущие значения для активного аккаунта из 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
Поля потребления
| Поле | Значение |
|---|---|
bytes_used | Байты сохраненных объектов, обновляемые операциями шлюза и сверкой |
pending_bytes | Резерв положительного роста, включая публикации с неизвестным результатом |
object_count | Число сохраненных объектов |
pending_objects | Резерв новых объектов, в том числе пустых |
quota_bytes, quota_objects | Действующие лимиты аккаунта |
unknown_writers | У старой операции нет известного резерва; рост требует восстановления оператором |
legacy_byte_limit | Байтовый лимит получен из прежней политики в ГиБ |
reconciled_at | Последняя успешная полная сверка или null |
Карточка хранилища включает зарезервированные байты в шкалу потребления, показывает резерв объектов отдельно и предупреждает о превышении лимита. Редактор политики аккаунта в админке показывает то же потребление и позволяет менять лимиты без перезапуска сервиса.
Лимиты относятся только к пользовательским файлам хранилища. Диски песочниц и
версии собственных шаблонов ограничиваются отдельно. В каждом слое политики
точные байты важнее прежнего значения в ГиБ.
Индивидуальные ограничения важнее тарифа: поэтому индивидуальный лимит
в ГиБ тоже важнее байтового лимита тарифа. Значение в ГиБ умножается на
1073741824; legacy_byte_limit показывает выбранный формат. Ноль означает
явный лимит, а не наследование.
Запись и резервы
| Операция | Допуск и учет |
|---|---|
| PUT нового ключа | Резерв всего размера и одного слота объектов |
| Перезапись через шлюз или по presigned URL | Резерв только положительного роста байтов, без нового слота |
| Перезапись тем же или меньшим размером | Доступна после понижения лимита или отзыва права записи |
| Удаление | Снимает измеренные байты и один объект; доступно после понижения тарифа |
| GET, HEAD, presigned GET | Не расходует дополнительную квоту байтов или объектов |
Шлюз последовательно допускает резервы в PostgreSQL. Учет опубликованного объекта и снятие резерва коммитятся вместе. Гарантия требует, чтобы все пишущие клиенты пользовались этим протоколом; прямые записи в бакет в нее не входят.
Ключом владеет только одна активная запись или сессия загрузки. Повторный PUT,
DELETE или запрос presigned URL для того же ключа получает
409 storage.operation_in_progress; чтение остается доступным. Для повтора
передачи используйте исходные идентификатор загрузки и URL. Разные ключи можно
записывать параллельно в пределах бюджета аккаунта.
Уже допущенная загрузка может завершиться после понижения лимита или отзыва
права; действующие учетные данные с доступом записи все равно обязательны.
Новый объект или рост без права записи в инсталляции, проверяющей это право,
может получить 404 feature.not_enabled.
Отмена и истечение загрузки
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 не снимает ее резерв. Старые загрузки в период совместимости могут резервировать полный размер.
Сверка и восстановление
Регулярная сверка читает полный список бакета. Ошибка любой страницы не дает
опубликовать частичные итоги. Аккаунты с незавершенными пишущими клиентами не получают
подтвержденные итоги и освобождение резерва автоматически. Оператор должен
закрыть новые изменения, дождаться завершения работы пишущих клиентов и сверить полный список.
Интервал зависит от инсталляции; 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 | Хранилище может быть выключено в инсталляции |