From bd54bc456dbd1a069d81434945dc996890e74f13 Mon Sep 17 00:00:00 2001 From: Anton Date: Thu, 14 Nov 2024 23:03:00 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9D=D0=B0=D1=87=D0=B0=D0=BB=D0=BE=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D0=B8=20S3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Media/S3.png | Bin 0 -> 3920 bytes docs/docusaurus/src/css/custom.css | 6 ++- docs/docusaurus/static/img/APIs/S3.png | Bin 0 -> 2240 bytes docs/docusaurus/static/img/APIs/small/S3.png | Bin 0 -> 1161 bytes docs/en/md/Instructions/S3.md | 51 +++++++++++++++++++ docs/ru/md/Instructions/S3.md | 51 +++++++++++++++++++ 6 files changed, 107 insertions(+), 1 deletion(-) create mode 100644 Media/S3.png create mode 100644 docs/docusaurus/static/img/APIs/S3.png create mode 100644 docs/docusaurus/static/img/APIs/small/S3.png create mode 100644 docs/en/md/Instructions/S3.md create mode 100644 docs/ru/md/Instructions/S3.md diff --git a/Media/S3.png b/Media/S3.png new file mode 100644 index 0000000000000000000000000000000000000000..9e0f5d27c814184b45ff951aed08319ef6012045 GIT binary patch literal 3920 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 eR8V*#BL4#+FPMUGRP(0*0000 a.menu__link { .Notion a::before, .GoogleCalendar a::before, .GoogleDrive a::before, .GoogleSheets a::before, .Slack a::before, .YandexDisk a::before, .Dropbox a::before, .Bitrix24 a::before, .Messenger a::before, .Social a::before, .Database a::before, .Folder a::before, .Calendar a::before, .CRM a::before, .Commerce a::before, -.VKTeams a::before, .Ozon a::before, .Neocities a::before, .CDEK a::before, .Start a::before, .Other a::before{ +.VKTeams a::before, .S3 a::before, .Ozon a::before, .Neocities a::before, .CDEK a::before, .Start a::before, .Other a::before{ padding-right: 0.7rem; padding-top: 0.4rem; } @@ -203,6 +203,10 @@ li > a.menu__link { content: url(../../static/img/APIs/small/CDEK.png); } +.S3 > div > a::before{ + content: url(../../static/img/APIs/small/S3.png); +} + .Messenger > div > a::before{ content: url(../../static/img/Categories/chat.png); } diff --git a/docs/docusaurus/static/img/APIs/S3.png b/docs/docusaurus/static/img/APIs/S3.png new file mode 100644 index 0000000000000000000000000000000000000000..d73a6c8692d16322dfec36d6aaff5be6dfd31aac GIT binary patch literal 2240 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 b^?| + +# S3 (MinIO) + +:::important + +S3 - is a standard used by different software products. This means that the availability of methods, as well as their parameters, may differ depending on what software you are using. MinIO-based object storage is used to develop and test this library + +::: + +This section is dedicated to the library for working with AWS S3 API. On this page, all the steps necessary to start working are described + +## Getting started + +1. Obtain the following authorization data to work with S3: + + + Access key + + Secret key + + Region + + Storage URL + + Type of service (by default - S3) + +2. Pass the received data to the `GetDataStructure` function and get the structure of the basic data + +```bsl title="1С:Enterprise/OneScript" + + URL = "storage-155.s3hoster.by"; + AccessKey = "BRN5RKJE67..."; + SecretKey = "NNhv+i9PrytpT8Tu0C1N..."; + Region = "BTC"; + + BasicData = OPI_S3.GetBasicDataStructure(URL, AccessKey, SecretKey, Region); + +``` + +```bash title="CLI" + + oint s3 GetBasicDataStructure + --url "storage-155.s3hoster.by" + --access "BRN5RKJE67..." + --secret "NNhv+i9PrytpT8Tu0C1N..." + --region "BTC" + +``` + +3. Use the resulting structure (or JSON) to call other methods of working with S3 API (`BasicData` parameter) diff --git a/docs/ru/md/Instructions/S3.md b/docs/ru/md/Instructions/S3.md new file mode 100644 index 0000000000..96317343cf --- /dev/null +++ b/docs/ru/md/Instructions/S3.md @@ -0,0 +1,51 @@ +--- +id: S3 +sidebar_class_name: S3 +--- + + + +# S3 (MinIO) + +:::important + +S3 - это стандарт, используемый различными программными продуктами. Это означает, что доступность методов, а также их параметры, могут отличаться в зависимости от того, какое ПО вы используете. Для разработки и тестирования данной библиотеки используется объектное хранилище на базе MinIO + +::: + +Этот раздел посвящен библиотеке для работы с AWS S3 API. На данной странице описаны все действия, необходимые для полноценного начала работы + +## Начало работы + +1. Получите следующие авторизационные данные для работы с S3: + + + Access key + + Secret key + + Region + + URL сервера + + Тип сервиса (по умолчанию - S3) + +2. Полученные данные передайте в функцию `ПолучитьСтруктуруДанных` и получите структуру основных данных + +```bsl title="1С:Предприятие/OneScript" + + URL = "storage-155.s3hoster.by"; + AccessKey = "BRN5RKJE67..."; + SecretKey = "NNhv+i9PrytpT8Tu0C1N..."; + Region = "BTC"; + + ОсновныеДанные = OPI_S3.ПолучитьСтруктуруДанных(URL, AccessKey, SecretKey, Region); + +``` + +```bash title="CLI" + + oint s3 ПолучитьСтруктуруДанных + --url "storage-155.s3hoster.by" + --access "BRN5RKJE67..." + --secret "NNhv+i9PrytpT8Tu0C1N..." + --region "BTC" + +``` + +3. Используйте полученную структуру (или JSON) для вызова других методов работы с S3 API (параметр `ОсновныеДанные`)