Init parts upload
Initializes the multipart object uploading
Function InitPartsUpload(Val Name, Val Bucket, Val BasicData, Val Headers = Undefined, Val Directory = False) Export
Parameter | CLI option | Type | Required | Description |
---|---|---|---|---|
Name | --name | String | ✔ | Name of the object in the bucket |
Bucket | --bucket | String | ✔ | Name of the bucket to put the object |
BasicData | --basic | Structure Of KeyAndValue | ✔ | Basic request data. See GetBasicDataStructure |
Headers | --headers | Map Of KeyAndValue | ✖ | Additional request headers, if necessary |
Directory | --dir | Boolean | ✖ | True > Path style URL, False > Virtual hosted style URL |
Returns: Structure Of KeyAndValue - serialized JSON response from storage
tip
Method at AWS documentation: CreateMultipartUpload
This is a service method. A PutObject
method is intended for the common scenario of files uploading
Using multipart upload for files < 5 MB or when the size of a single chunk is < 5 MB will result in an error
1C:Enterprise/OneScript code example
URL = "storage-155.s3hoster.by";
AccessKey = "BRN5RKJE67...";
SecretKey = "NNhv+i9PrytpT8Tu0C1N...";
Region = "BTC";
BasicData = OPI_S3.GetBasicDataStructure(URL, AccessKey, SecretKey, Region);
Name = "fileChunked.mp3";
Directory = True; // Formation URL in path-style
Bucket = "opi-dirbucket3";
Entity = "https://hut.openintegrations.dev/test_data/song.mp3"; // URL, Path or Binary Data
Entity = OPI_HTTPRequests.Get(Entity);
Result = OPI_S3.InitPartsUpload(Name, Bucket, BasicData, , Directory);
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
UploadID = Result["response"]["InitiateMultipartUploadResult"]["UploadId"];
TotalSize = Entity.Size();
ChunkSize = 5242880;
BytesRead = 0;
PartNumber = 1;
DataReader = New DataReader(Entity);
SourceStream = DataReader.SourceStream();
TagsArray = New Array;
While BytesRead < TotalSize Do
CurrentReading = DataReader.Read(ChunkSize);
CurrentData = CurrentReading.GetBinaryData();
If CurrentData.Size() = 0 Then
Break;
EndIf;
Result = OPI_S3.UploadObjectPart(Name
, Bucket
, BasicData
, UploadID
, PartNumber
, CurrentData
, Directory);
BytesRead = SourceStream.CurrentPosition();
ETag = Result["headers"]["Etag"];
ETag = ?(ETag = Undefined, Result["headers"]["ETag"], ETag);
TagsArray.Add(ETag);
PartNumber = PartNumber + 1;
EndDo;
Result = OPI_S3.FinishPartsUpload(Name, Bucket, BasicData, UploadID, TagsArray, , Directory);
- Bash
- CMD/Bat
oint s3 InitPartsUpload \
--name "fileChunked.mp3" \
--bucket "opi-dirbucket3" \
--basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}" \
--dir true
oint s3 InitPartsUpload ^
--name "fileChunked.mp3" ^
--bucket "opi-dirbucket3" ^
--basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}" ^
--dir true
Result
{
"status": 200,
"response": {
"InitiateMultipartUploadResult": {
"Bucket": "opi-dirbucket3",
"Key": "fileChunked.mp3",
"UploadId": "MDk2NGE5MDUtNDcxZS00ZDljLTkzYjMtODM5ZDM4NGMyMWVhLjg2ZmI0MjM4LTNiYTAtNDE3My1iNGRmLTA0NmQ1YmM3OGJmZQ"
}
},
"headers": {
"Accept-Ranges": "bytes",
"Date": "Mon, 15 Sep 2025 23:16:02 GMT",
"Server": "MinIO",
"Strict-Transport-Security": "max-age=31536000; includeSubDomains",
"Vary": "Origin, Accept-Encoding",
"X-Amz-Id-2": "e602da57d0c30b8c7034fcfe129917205f80f7bab979408e71da5d1441c85e79",
"X-Amz-Request-Id": "186597D2FEC7C465",
"X-Content-Type-Options": "nosniff",
"X-XSS-Protection": "1; mode=block",
"Content-Length": "326",
"Content-Type": "application/xml"
}
}