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

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

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

# создать бакет и залить файл
$ aws s3 mb s3://media-prod --endpoint-url https://samaras3.nimbusedge.ru
$ aws s3 cp clip.ts s3://media-prod/objects/v2/chunks/fetch/ --endpoint-url https://samaras3.nimbusedge.ru

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

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

S3 API

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

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

$ curl -O https://samaras3.nimbusedge.ru/media-prod/objects/v2/chunks/fetch/clip.ts

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

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

$ nimbus presign media-prod/objects/v2/chunks/fetch/clip.ts --expires 3600
https://samaras3.nimbusedge.ru/objects/v2/chunks/fetch/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://samaras3.nimbusedge.ru")
s3.upload_file("clip.ts", "media-prod", "objects/v2/chunks/fetch/clip.ts")

Лимиты

Регионы

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

Самара · Уфа · Пермь · Тольятти · Оренбург · Саратов и ещё 3 PoP.

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