Перейти к основному содержимому
Открыть Markdown

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

У файлового хранилища аккаунта есть отдельные лимиты байтов и объектов. Получайте текущие значения для активного аккаунта из 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Хранилище может быть выключено в инсталляции