mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-04-13 11:50:53 +02:00
91 lines
5.0 KiB
Plaintext
91 lines
5.0 KiB
Plaintext
---
|
|
sidebar_position: 1
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
# Загрузить объект
|
|
Загружает файл в бакет
|
|
|
|
|
|
|
|
`Функция ЗагрузитьОбъект(Знач Наименование, Знач Бакет, Знач Содержимое, Знач ОсновныеДанные, Знач Заголовки = Неопределено) Экспорт`
|
|
|
|
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|
|
|-|-|-|-|-|
|
|
| Наименование | --name | Строка | ✔ | Наименование объекта в бакете |
|
|
| Бакет | --bucket | Строка | ✔ | Имя бакета для загрузки объекта |
|
|
| Содержимое | --data | Строка, ДвоичныеДанные | ✔ | Данные или путь к файлу для загрузки |
|
|
| ОсновныеДанные | --basic | Структура Из КлючИЗначение | ✔ | Основные данные запроса. См. ПолучитьСтруктуруДанных |
|
|
| Заголовки | --headers | Соответствие Из КлючИЗначение | ✖ | Дополнительные заголовки запроса, если необходимо |
|
|
|
|
|
|
Возвращаемое значение: Структура Из КлючИЗначение - сериализованный JSON ответа от хранилища
|
|
|
|
<br/>
|
|
|
|
:::tip
|
|
Метод в документации AWS (стандартный): [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)<br/>Метод в документации AWS (по частям): [Multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html)
|
|
|
|
Вы можете использовать поле `ChunkSize` в основных данных для указания минимального размера и величины чанка загрузки по частям. Например, `ChunkSize равный X` означает, что все файлы, размером больше `X` (в байтах) будут загружаться по частям, где одна часть будет размером `X`. Загрузка по частям используется для больших файлов. Стандартный размер `ChunkSize` - 20971520 байт (20 МБайт)
|
|
|
|
Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL
|
|
:::
|
|
<br/>
|
|
|
|
|
|
```bsl title="Пример использования для 1С:Предприятие/OneScript"
|
|
URL = "storage-155.s3hoster.by";
|
|
AccessKey = "BRN5RKJE67...";
|
|
SecretKey = "NNhv+i9PrytpT8Tu0C1N...";
|
|
Region = "BTC";
|
|
|
|
ОсновныеДанные = OPI_S3.ПолучитьСтруктуруДанных(URL, AccessKey, SecretKey, Region);
|
|
|
|
Наименование = "picture.jpg";
|
|
Бакет = "opi-gpbucket3";
|
|
Содержимое = "https://api.athenaeum.digital/test_data/picture.jpg"; // URL, Путь или Двоичные данные
|
|
|
|
Результат = OPI_S3.ЗагрузитьОбъект(Наименование, Бакет, Содержимое, ОсновныеДанные);
|
|
|
|
Наименование = "fileChunked.mp3";
|
|
Бакет = "opi-gpbucket3";
|
|
Содержимое = "https://api.athenaeum.digital/test_data/song.mp3"; // URL, Путь или Двоичные данные
|
|
|
|
ОсновныеДанные.Вставить("ChunkSize", 5242880);
|
|
|
|
Результат = OPI_S3.ЗагрузитьОбъект(Наименование, Бакет, Содержимое, ОсновныеДанные);
|
|
```
|
|
|
|
|
|
<Tabs>
|
|
|
|
<TabItem value="bash" label="Bash" default>
|
|
```bash
|
|
# JSON данные также могут быть переданы как путь к файлу .json
|
|
|
|
oint s3 ЗагрузитьОбъект \
|
|
--name "picture.jpg" \
|
|
--bucket "opi-gpbucket3" \
|
|
--data "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg" \
|
|
--basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}"
|
|
```
|
|
</TabItem>
|
|
|
|
<TabItem value="bat" label="CMD/Bat" default>
|
|
```batch
|
|
:: JSON данные также могут быть переданы как путь к файлу .json
|
|
|
|
oint s3 ЗагрузитьОбъект ^
|
|
--name "picture.jpg" ^
|
|
--bucket "opi-gpbucket3" ^
|
|
--data "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/picture.jpg" ^
|
|
--basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}"
|
|
```
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
|
|
|