OpenIntegrations/docs/ru/md/Instructions/S3.md

id, sidebar_class_name

id	sidebar_class_name
S3	S3

<img src={require('../../static/img/APIs/S3.png').default} width='64px' />

AWS S3 (MinIO)

Этот раздел посвящен библиотеке для работы с AWS S3 API. На данной странице описаны все действия, необходимые для полноценного начала работы

:::important

S3 - это стандарт, используемый различными программными продуктами. Это означает, что доступность методов, а также их параметры, могут отличаться в зависимости от того, какое ПО вы используете. Для разработки и тестирования данной библиотеки используется объектное хранилище на базе MinIO

:::

Начало работы

1. Получите следующие авторизационные данные для работы с S3:

   • Access key
   • Secret key
   • Region
   • URL сервера
   • Тип сервиса (по умолчанию - S3)

2. Полученные данные передайте в функцию ПолучитьСтруктуруДанных и получите структуру основных данных

    URL       = "storage-155.s3hoster.by";
    AccessKey = "BRN5RKJE67...";
    SecretKey = "NNhv+i9PrytpT8Tu0C1N...";
    Region    = "BTC";

    ОсновныеДанные = OPI_S3.ПолучитьСтруктуруДанных(URL, AccessKey, SecretKey, Region);

    oint s3 ПолучитьСтруктуруДанных 
        --url "storage-155.s3hoster.by"
        --access "BRN5RKJE67..."
        --secret "NNhv+i9PrytpT8Tu0C1N..."
        --region "BTC"

Полученную структуру (или JSON файл) нужно использовать для вызова других методов работы с S3 API (параметр ОсновныеДанные) - авторизационные данные и дополнительные настройки запросов будут определяться на ее основе

Формат ответа

Данная библиотека использует собственный формат ответа для предоставления данных, полученных от сервера. Он выглядит следующим образом:

{
    "status": 200,
    "response": {}
}

• В поле status записывается код состояния HTTP-ответа
• В поле response помещается тело оригинального ответа S3, предварительно преобразованное из XML в JSON

Это сделано для упрощения работы с библиотекой, так как формат XML более громоздок и сложен в работе, по сравнению с JSON