Перейти к основному содержимому

Объектное хранилище

TatNet предоставляет платное S3-совместимое объектное хранилище. Биллинг — по объёму хранения (ГБ в месяц) и исходящему трафику.

Регион и эндпоинт​

Регион — kzn-1. Эндпоинт:

https://kzn-1.s3.tatcloud.ru

Поддерживаются оба стиля адресации:

  • path-style: https://kzn-1.s3.tatcloud.ru/{bucket}/{key}
  • virtual-hosted: https://{bucket}.kzn-1.s3.tatcloud.ru/{key}

Ключи доступа и авторизация​

Запросы авторизуются по протоколу AWS Signature Version 4 (SigV4) — с любым совместимым клиентом или SDK. В панели вы создаёте ключи доступа (access key id / secret). Ключ может быть глобальным или ограниченным набором конкретных бакетов.

Подключение к Kubernetes​

Бакет можно подключить к подам managed Kubernetes через GeeseFS CSI. См. создание Secret, StorageClass и PVC. Размер PVC не ограничивает объём бакета; данные учитываются по фактическому использованию.

Пример (AWS CLI)​

aws configure set aws_access_key_id <ACCESS_KEY_ID>
aws configure set aws_secret_access_key <SECRET_ACCESS_KEY>

aws --endpoint-url https://kzn-1.s3.tatcloud.ru \
s3 ls

aws --endpoint-url https://kzn-1.s3.tatcloud.ru \
s3 cp ./file.txt s3://my-bucket/file.txt

Управление бакетами​

Бакеты создаются и удаляются через S3-совместимый API или из панели. В панели также есть файловый менеджер для просмотра, загрузки и удаления объектов.

Биллинг

Хранение — 2 ₽ за ГБ в месяц, с почасовой тарификацией по фактическому объёму. Исходящий трафик S3 — 1,3 ₽ за ГБ: скачивание файлов, публичные ссылки и раздача превью оплачиваются по переданным байтам. Загрузка файлов в S3 не тарифицируется. 1 ГБ = 1 000 000 000 байт.

Хранение и исходящий трафик отображаются отдельными списаниями в биллинге панели.

Превью изображений​

Для изображений в публичном бакете доступны уменьшенные копии без изменения оригинала. Путь на региональном S3-эндпоинте:

https://kzn-1.s3.tatcloud.ru/-/image/{пресет}/{бакет}/{ключ}

Используйте имя бакета из публичного S3-адреса. Ключ может содержать каталоги; пробелы и кириллицу кодируйте как компоненты URL, сохраняя / между каталогами.

ПресетРезультат
w160, w320, w480, w640, w960, w1280, w1920вписать по ширине с сохранением пропорций
cover160, cover320, cover480, cover640квадрат указанного размера с обрезкой

Пример для публичного изображения:

<img src="https://kzn-1.s3.tatcloud.ru/-/image/w480/my-bucket/photos/cover.jpg"
alt="Обложка" loading="lazy" />

Если браузер принимает WebP, шлюз отдаёт превью в WebP. Приватный бакет этот маршрут публичным не делает: он отвечает 403. Неизвестный пресет или отсутствующий объект возвращает 404; неподдерживаемый тип — 415. Исходящий трафик превью оплачивается как трафик S3.