S3-API

S3 API - это API на основе Amazon S3, который позволяет работать с ресурсами объектного хранилища.

Он предоставляет следующие возможности:

• просмотр информации о количестве и размере бакетов и объектов,
• создание и удаление бакетов,
• загрузка, просмотр, копирование, перемещение, скачивание и удаление объектов в бакетах,
• управление сегментированной загрузкой объектов и управление CORS.

Доступ к API

Доступ к S3 API возможен только для авторизованных пользователей.

Для доступа к бакетам через S3 API у пользователя должна быть роль с доступом к объектному хранилищу. Как управлять доступом в объектном хранилище подробнее рассмотрено в инструкции.

Адрес (URL) при использовании Path-Style адресации (по умолчанию): https://s3.adman.com

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

В S3 API поддерживается подпись запросов версий AWS Signature Version 2 и AWS Signature Version 4.

Для формирования подписи необходимы ключи доступа, которые указаны в заказе S3-хранилища:

• Access Key ID: идентификатор ключа access Key, который вы получили при создании заказа, также указан в информации о заказе.
• Secret Access Key: секретный ключ Secret Key, который вы получили при создании заказа.

Подписать запрос можно одним из методов:

• через HTTP-заголовок Authorization, подробнее в инструкции Authenticating Requests: Using the Authorization Header (AWS Signature Version 4) документации Amazon;
• через query-параметры или подписанный URL (Presigned URL), подробнее в инструкции Authenticating Requests: Using Query Parameters (AWS Signature Version 4) документации Amazon.При таком методе можно указать все параметры запроса в URL.