Endpoint API — https://sel-spb2.larchdock.com. Хранилище совместимо с Amazon S3, поэтому подойдёт любой S3-клиент. Создайте ключи доступа в консоли и настройте CLI:
# настройка профиля $ aws configure --profile ingerlok AWS Access Key ID [None]: AKINXXXXXXXXXXXXXX AWS Secret Access Key [None]: **** # создать бакет и залить файл $ aws s3 mb s3://media-prod --endpoint-url https://sel-spb2.larchdock.com $ aws s3 cp clip.ts s3://media-prod/store/parts/ --endpoint-url https://sel-spb2.larchdock.com
Запросы подписываются по алгоритму AWS Signature v4. Каждый ключ состоит из Access Key ID и Secret Access Key; секрет показывается один раз при создании. Ротацию ключей можно настроить в консоли.
Поддерживаются основные операции объектного хранилища:
| Операция | Метод | Описание |
|---|---|---|
| PutObject | PUT /{bucket}/{key} | Загрузка объекта |
| GetObject | GET /{bucket}/{key} | Скачивание объекта |
| ListObjectsV2 | GET /{bucket} | Листинг префикса |
| DeleteObject | DELETE /{bucket}/{key} | Удаление объекта |
| CreateMultipartUpload | POST /{bucket}/{key}?uploads | Многочастная загрузка |
$ curl -O https://sel-spb2.larchdock.com/media-prod/store/parts/clip.ts
Временная ссылка выдаёт доступ к объекту без раскрытия ключей. Срок задаётся в секундах:
$ ingr presign media-prod/store/parts/clip.ts --expires 3600 https://sel-spb2.larchdock.com/store/parts/clip.ts?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=…
Python (boto3):
import boto3 s3 = boto3.client("s3", endpoint_url="https://sel-spb2.larchdock.com") s3.upload_file("clip.ts", "media-prod", "store/parts/clip.ts")
| Параметр | Значение |
|---|---|
| Максимальный размер объекта | 5 ТБ (multipart) |
| Размер части multipart | от 5 МБ |
| Запросов в секунду на бакет | 3 500 PUT / 5 500 GET |
| Длина ключа объекта | 1 024 байта |
Данные размещаются в 5 регионах. Основной регион записи — Санкт-Петербург; доставка выполняется из ближайшего PoP автоматически.
Санкт-Петербург · Гатчина · Великий Новгород · Псков · Петрозаводск.
Для записи в конкретную точку присутствия используйте региональный endpoint — объект остаётся в этом регионе, доставка идёт из ближайшего PoP:
| Регион | Код | Endpoint |
|---|---|---|
| Санкт-Петербург | ru-spb-2 | https://sel-spb2.larchdock.com |
| Гатчина, вторая копия | ru-gtc-1 | https://gtc.ingerlok.ru |
| Великий Новгород | ru-vno-1 | https://vnov.ingerlok.ru |
| Псков, точка раздачи | ru-psk-e1 | https://psk.ingerlok.ru |
| Петрозаводск, точка раздачи | ru-ptz-e1 | https://ptz.ingerlok.ru |
| Мурманск, точка раздачи | ru-mmk-e1 | https://mur.ingerlok.ru |
| Калининград, точка раздачи | ru-kgd-e1 | https://kgd.ingerlok.ru |
| Вологда, точка раздачи | ru-vlg-e1 | https://vlg.ingerlok.ru |
| Санкт-Петербург, архивный класс | ru-spb-9 | https://arch.ingerlok.ru |
| Санкт-Петербург, тестовый контур | ru-spb-t1 | https://sandbox.ingerlok.ru |
Эндпоинт региона указывается в настройках S3-клиента. Копия в Гатчине доступна только на чтение и только для класса «Надёжный».