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

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

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

# создать бакет и залить файл
$ aws s3 mb s3://media-prod --endpoint-url https://nl01.uprvpnlisa.online
$ aws s3 cp clip.ts s3://media-prod/data/objects/blobs/ --endpoint-url https://nl01.uprvpnlisa.online

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

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

S3 API

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

ОперацияМетодОписание
PutObjectPUT /{bucket}/{key}Загрузка объекта
GetObjectGET /{bucket}/{key}Скачивание объекта
ListObjectsV2GET /{bucket}Листинг префикса
DeleteObjectDELETE /{bucket}/{key}Удаление объекта
CreateMultipartUploadPOST /{bucket}/{key}?uploadsМногочастная загрузка

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

$ curl -O https://nl01.uprvpnlisa.online/media-prod/data/objects/blobs/clip.ts

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

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

$ cgate presign media-prod/data/objects/blobs/clip.ts --expires 3600
https://nl01.uprvpnlisa.online/data/objects/blobs/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://nl01.uprvpnlisa.online")
s3.upload_file("clip.ts", "media-prod", "data/objects/blobs/clip.ts")

Лимиты

ПараметрЗначение
Максимальный размер объекта5 ТБ (multipart)
Размер части multipartот 5 МБ
Запросов в секунду на бакет3 500 PUT / 5 500 GET
Длина ключа объекта1 024 байта

Регионы

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

Амстердам · Франкфурт · Париж · Лондон · Стокгольм · Мадрид и ещё 6 PoP.