Webhooks

С Webhooks для S3, используя API, можно настраивать отправку таких HTTP и HTTPS запросов по событиям для бакета, как:

• обработка и конвертирование файлов после загрузки;
• интегрирование с разными внешними системами;
• логирование для объектного хранилища.

События (Event), для которых можно настроить конфигурацию Webhooks:

• s3:ObjectCreated:* — PutObject, PutObjectCopy, CompleteMultipartUpload.
• s3:ObjectCreated:Put — PutObject.
• s3:ObjectCreated:Copy — PutObjectCopy.
• s3:ObjectCreated:CompleteMultipartUpload — CompleteMultipartUpload.
• s3:ObjectRemoved:* — DeleteObject.
• s3:ObjectRemoved:Delete — DeleteObject.

Для работы с Webhooks доступно два метода:

• PutBucketNotificationConfiguration;
• GetBucketNotificationConfiguration.

Используя метод PUT можно настроить уведомления о некоторых событиях (PutObject, DeleteObject и т.д) в бакете.

Сейчас поддерживается один тип событий — SimpleTopicConfiguration — запрос на url, предоставленный пользователем.

Например, необходимо выполнить запрос на url https://test.com при PutObject в бакет bucketA объектов, имена которых подходят под маску image/*.png.

Запрос:

Ответ:

Метод GET возвращает текущую конфигурацию правил (SimpleNotificationConfiguration) бакета. Если же правила для данного бакета не были установлены, то будет возращен пустой элемент NotificationConfiguration.

Запрос:

Ответ:

Для примера установленных правил, при загрузкие объектов в бакет bucketA с именами image/*.png, будет приходить следующий запрос:

В процессе выполнения запроса сервис LinxCloud S3 валидирует url, выполняя на него запрос(2):

Чтобы подтвердить url нужно в ответ отправить подпись:

Для приведенного примера:

Ответ на запрос(1), при успешном подтверждении url, будет отправлен response: