Быстрый старт

Endpoint API — https://bs1.larchdock.com. Хранилище совместимо с Amazon S3, поэтому подойдёт любой S3-клиент. Создайте ключи доступа в консоли и настройте CLI:

# настройка профиля
$ aws configure --profile nevaklad
AWS Access Key ID     [None]: AKNEXXXXXXXXXXXXXX
AWS Secret Access Key [None]: ****

# создать бакет и залить файл
$ aws s3 mb s3://media-prod --endpoint-url https://bs1.larchdock.com
$ aws s3 cp clip.ts s3://media-prod/archive/v2/parts/ --endpoint-url https://bs1.larchdock.com

Аутентификация

Запросы подписываются по алгоритму AWS Signature v4. Каждый ключ состоит из Access Key ID и Secret Access Key; секрет показывается один раз при создании. Ротацию ключей можно настроить в консоли.

S3 API

Поддерживаются основные операции объектного хранилища:

Пример: скачивание объекта

$ curl -O https://bs1.larchdock.com/media-prod/archive/v2/parts/clip.ts

Подписанные ссылки

Временная ссылка выдаёт доступ к объекту без раскрытия ключей. Срок задаётся в секундах:

$ nvk presign media-prod/archive/v2/parts/clip.ts --expires 3600
https://bs1.larchdock.com/archive/v2/parts/clip.ts?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=…

SDK

Python (boto3):

import boto3
s3 = boto3.client("s3", endpoint_url="https://bs1.larchdock.com")
s3.upload_file("clip.ts", "media-prod", "archive/v2/parts/clip.ts")

Лимиты

Регионы

Данные размещаются в 8 регионах. Основной регион записи — Санкт-Петербург; доставка выполняется из ближайшего PoP автоматически.

Санкт-Петербург · Москва · Великий Новгород · Псков · Петрозаводск · Мурманск · Калининград · Вологда.

Для записи в конкретную точку присутствия используйте региональный endpoint — объект остаётся в этом регионе, доставка идёт из ближайшего PoP:

Узлы в Новгороде, Пскове, Петрозаводске, Мурманске, Калининграде и Вологде только раздают файлы — для записи используйте эндпоинт Петербурга или Москвы.