mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-04-11 11:41:56 +02:00
118 lines
5.3 KiB
Plaintext
118 lines
5.3 KiB
Plaintext
---
|
|
sidebar_position: 3
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
# Инициализировать загрузку частями
|
|
Инициализирует загрузку объекта по частям
|
|
|
|
|
|
|
|
`Функция ИнициализироватьЗагрузкуЧастями(Знач Наименование, Знач Бакет, Знач ОсновныеДанные, Знач Заголовки = Неопределено) Экспорт`
|
|
|
|
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|
|
|-|-|-|-|-|
|
|
| Наименование | --name | Строка | ✔ | Наименование объекта в бакете |
|
|
| Бакет | --bucket | Строка | ✔ | Имя бакета для загрузки объекта |
|
|
| ОсновныеДанные | --basic | Структура Из КлючИЗначение | ✔ | Основные данные запроса. См. ПолучитьСтруктуруДанных |
|
|
| Заголовки | --headers | Соответствие Из КлючИЗначение | ✖ | Дополнительные заголовки запроса, если необходимо |
|
|
|
|
|
|
Возвращаемое значение: Структура Из КлючИЗначение - сериализованный JSON ответа от хранилища
|
|
|
|
<br/>
|
|
|
|
:::tip
|
|
Метод в документации AWS: [CreateMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
|
|
|
|
Это служебный метод. Для основного сценария загрузки файлов предназначен единый метод `ЗагрузитьОбъект`<br/>Использование загрузки частями для файлов < 5 МБ или при размере одной части < 5 МБ приведет к ошибке
|
|
:::
|
|
<br/>
|
|
|
|
|
|
```bsl title="Пример использования для 1С:Предприятие/OneScript"
|
|
URL = "storage-155.s3hoster.by";
|
|
AccessKey = "BRN5RKJE67...";
|
|
SecretKey = "NNhv+i9PrytpT8Tu0C1N...";
|
|
Region = "BTC";
|
|
|
|
ОсновныеДанные = OPI_S3.ПолучитьСтруктуруДанных(URL, AccessKey, SecretKey, Region);
|
|
|
|
Наименование = "fileChunked.mp3";
|
|
Бакет = "opi-gpbucket3";
|
|
|
|
Содержимое = "https://api.athenaeum.digital/test_data/song.mp3"; // URL, Путь или Двоичные данные
|
|
Содержимое = OPI_Инструменты.Get(Содержимое);
|
|
|
|
Результат = OPI_S3.ИнициализироватьЗагрузкуЧастями(Наименование, Бакет, ОсновныеДанные);
|
|
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
IDЗагрузки = Результат["response"]["InitiateMultipartUploadResult"]["UploadId"];
|
|
ОбщийРазмер = Содержимое.Размер();
|
|
РазмерУчастка = 5242880;
|
|
ПрочитаноБайт = 0;
|
|
НомерЧасти = 1;
|
|
|
|
ЧтениеДанных = Новый ЧтениеДанных(Содержимое);
|
|
ИсходныйПоток = ЧтениеДанных.ИсходныйПоток();
|
|
МассивТегов = Новый Массив;
|
|
|
|
Пока ПрочитаноБайт < ОбщийРазмер Цикл
|
|
|
|
ТекущееЧтение = ЧтениеДанных.Прочитать(РазмерУчастка);
|
|
ТекущиеДанные = ТекущееЧтение.ПолучитьДвоичныеДанные();
|
|
|
|
Если ТекущиеДанные.Размер() = 0 Тогда
|
|
Прервать;
|
|
КонецЕсли;
|
|
|
|
Результат = OPI_S3.ЗагрузитьЧастьОбъекта(Наименование
|
|
, Бакет
|
|
, ОсновныеДанные
|
|
, IDЗагрузки
|
|
, НомерЧасти
|
|
, ТекущиеДанные);
|
|
|
|
ПрочитаноБайт = ИсходныйПоток.ТекущаяПозиция();
|
|
МассивТегов.Добавить(Результат["headers"]["Etag"]);
|
|
|
|
Прервать;
|
|
|
|
НомерЧасти = НомерЧасти + 1;
|
|
|
|
КонецЦикла;
|
|
|
|
Результат = OPI_S3.ЗавершитьЗагрузкуЧастями(Наименование, Бакет, ОсновныеДанные, IDЗагрузки, МассивТегов);
|
|
```
|
|
|
|
|
|
|
|
|
|
```json title="Результат"
|
|
{
|
|
"status": 200,
|
|
"response": {
|
|
"InitiateMultipartUploadResult": {
|
|
"Bucket": "opi-gpbucket3",
|
|
"Key": "fileChunked.mp3",
|
|
"UploadId": "MDk2NGE5MDUtNDcxZS00ZDljLTkzYjMtODM5ZDM4NGMyMWVhLjYwODg4N2ViLTg3NDItNDk2Mi04NzMyLThhN2Y0NDY3NjA5MA"
|
|
}
|
|
},
|
|
"headers": {
|
|
"Accept-Ranges": "bytes",
|
|
"Content-Length": "325",
|
|
"Content-Type": "application/xml",
|
|
"Date": "Thu, 21 Nov 2024 09:09:48 GMT",
|
|
"Server": "MinIO",
|
|
"Strict-Transport-Security": "max-age=31536000; includeSubDomains",
|
|
"Vary": "Origin,Accept-Encoding",
|
|
"X-Amz-Id-2": "0757065d17b69556603743b9ea63f04bc7b9f349245bbff6b0ba901258e9c169",
|
|
"X-Amz-Request-Id": "1809F0B427028E99",
|
|
"X-Content-Type-Options": "nosniff",
|
|
"X-Xss-Protection": "1; mode=block"
|
|
}
|
|
}
|
|
```
|