OpenIntegrations/docs/ru/md/S3/Objects-management/Upload-object-part.mdx

---
sidebar_position: 4
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Загрузить часть объекта
 Загружает часть объекта при загрузке по частям



`Функция ЗагрузитьЧастьОбъекта(Знач Наименование, Знач Бакет, Знач ОсновныеДанные, Знач IDЗагрузки, Знач НомерЧасти, Знач Данные, Знач Заголовки = Неопределено) Экспорт`

  | Параметр | CLI опция | Тип | Обяз. | Назначение |
  |-|-|-|-|-|
  | Наименование | --name | Строка | ✔ | Наименование объекта в бакете |
  | Бакет | --bucket | Строка | ✔ | Имя бакета для загрузки объекта |
  | ОсновныеДанные | --basic | Структура Из КлючИЗначение | ✔ | Основные данные запроса. См. ПолучитьСтруктуруДанных |
  | IDЗагрузки | --upload | Строка | ✔ | ID загрузки по частям. См. ИнициализироватьЗагрузкуЧастями |
  | НомерЧасти | --part | Число, Строка | ✔ | Порядковый номер части объекта от 1 до 10000 |
  | Данные | --content | ДвоичныеДанные, Строка | ✔ | Данные части для загрузки |
  | Заголовки | --headers | Соответствие Из КлючИЗначение | ✖ | Дополнительные заголовки запроса, если необходимо |

  
  Возвращаемое значение:   Структура Из КлючИЗначение - сериализованный JSON ответа от хранилища

<br/>

:::tip
Метод в документации AWS: [UploadPart](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)

Это служебный метод. Для простого сценария загрузки файлов предназначен единый метод `ЗагрузитьОбъект`

Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL
:::
<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Загрузки, МассивТегов);
```