2024-11-21 11:30:08 +03:00
|
|
|
---
|
|
|
|
|
sidebar_position: 5
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
|
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
|
|
|
|
|
|
# Finish parts upload
|
|
|
|
|
Confirms the multipart uploading finish
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
`Function FinishPartsUpload(Val Name, Val Bucket, Val BasicData, Val UploadID, Val TagsArray, Val Headers = Undefined) 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 |
|
|
|
|
|
| UploadID | --upload | String | ✔ | Upload ID. See InitPartsUpload |
|
|
|
|
|
| TagsArray | --tags | Array Of String | ✔ | An array of tags (Etag) from the uploads responses of each part |
|
|
|
|
|
| Headers | --headers | Map Of KeyAndValue | ✖ | Additional request headers, if necessary |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Returns: Structure of KeyAndValue - serialized JSON response from storage
|
|
|
|
|
|
|
|
|
|
<br/>
|
|
|
|
|
|
|
|
|
|
:::tip
|
2024-11-21 13:27:18 +03:00
|
|
|
Method at AWS documentation: [CompleteMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
|
|
|
|
|
|
2024-11-22 09:37:00 +03:00
|
|
|
This is a service method. A `PutObject` method is intended for the common scenario of files uploading
|
2024-11-21 11:30:08 +03:00
|
|
|
:::
|
|
|
|
|
<br/>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```bsl title="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";
|
|
|
|
|
Bucket = "opi-gpbucket3";
|
|
|
|
|
|
|
|
|
|
Entity = "https://api.athenaeum.digital/test_data/song.mp3"; // URL, Path or Binary Data
|
|
|
|
|
Entity = OPI_Tools.Get(Entity);
|
|
|
|
|
|
|
|
|
|
Result = OPI_S3.InitPartsUpload(Name, Bucket, BasicData);
|
|
|
|
|
|
|
|
|
|
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);
|
|
|
|
|
|
|
|
|
|
BytesRead = SourceStream.CurrentPosition();
|
|
|
|
|
TagsArray.Add(Result["headers"]["Etag"]);
|
|
|
|
|
|
|
|
|
|
PartNumber = PartNumber + 1;
|
|
|
|
|
|
|
|
|
|
EndDo;
|
|
|
|
|
|
|
|
|
|
Result = OPI_S3.FinishPartsUpload(Name, Bucket, BasicData, UploadID, TagsArray);
|
|
|
|
|
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
