Документация TCN Storage
У TCN Storage два API: S3-совместимый API данных для объектов и REST Management API для рабочих пространств, ключей, настроек edge и статистики.
Понятия
- Рабочее пространство — граница биллинга и доступа. Участники, настройки SSO и ключи доступа принадлежат пространству.
- Бакет — контейнер объектов с домашним регионом. Имена глобально уникальны: 3–63 символа, строчные буквы, цифры и дефисы.
- Объект — ключ, данные и метаданные. Ключ — до 1024 байт UTF-8.
- Ключ доступа — id и секрет для S3 Signature V4 с ограничением по бакетам, префиксам и действиям.
- Edge-хост — публичный адрес доставки бакета,
<bucket>.cdn.tcnstorage.store, или ваш CNAME.
Endpoint
Отправляйте S3-запросы на endpoint домашнего региона бакета. Запросы на endpoint другого региона получают 301 PermanentRedirect с правильным адресом.
| Регион | Город | S3 endpoint |
|---|---|---|
| fra1 | Франкфурт | https://fra1.s3.tcnstorage.store |
| ams1 | Амстердам | https://ams1.s3.tcnstorage.store |
| waw1 | Варшава | https://waw1.s3.tcnstorage.store |
| sto1 | Стокгольм | https://sto1.s3.tcnstorage.store |
| ist1 | Стамбул | https://ist1.s3.tcnstorage.store |
| evn1 | Ереван | https://evn1.s3.tcnstorage.store |
| ala1 | Алматы | https://ala1.s3.tcnstorage.store |
| dxb1 | Дубай | https://dxb1.s3.tcnstorage.store |
| sin1 | Сингапур | https://sin1.s3.tcnstorage.store |
| tyo1 | Токио | https://tyo1.s3.tcnstorage.store |
Management API глобальный: https://api.tcnstorage.store/v1.
Аутентификация
S3 API использует AWS Signature Version 4: регион подписи — код региона, сервис — s3. Неподписанные запросы принимаются только для публичных бакетов.
Management API использует bearer-токены, которые создаются в консоли в разделе Настройки → API-токены. Токен показывается один раз и может быть ограничен правами только на чтение.
Не храните секреты в коде. Загружайте ключи из переменных окружения или менеджера секретов и ротируйте не реже раза в 90 дней.