Skip to main content

Get object

Gets the contents of the object from the bucket

Function GetObject(Val Name, Val Bucket, Val BasicData, Val Version = "", Val Headers = Undefined, Val SavePath = "", Val Directory = False) Export

ParameterCLI optionTypeRequiredDescription
Name--nameString✔Name of the object in the bucket
Bucket--bucketString✔Name of the bucket in which the object is stored
BasicData--basicStructure Of KeyAndValue✔Basic request data. See GetBasicDataStructure
Version--verString✖Token for receiving a specific version of an object
Headers--headersMap Of KeyAndValue✖Additional request headers, if necessary
SavePath--outString✖Path to directly write a file to disk
Directory--dirBoolean✖True > Path style URL, False > Virtual hosted style URL

Returns: BinaryData, String - object content or file path, if a save path is specified


tip

Method at AWS documentation: GetObjectAttributes

You can use the ChunkSize field in the basic data to specify the minimum file and chunk size for a chunked upload For example, ChunkSize=X means that all files larger than X (in bytes) will be downloaded in chunks, where one chunk will be of size X. Chunk upload is used for large files. Default ChunkSize - 20971520 bytes (20 MB)


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 = "picture.jpg";

    Directory = True; // Formation URL in path-style
    Bucket = "opi-dirbucket3";
    Result = OPI_S3.GetObject(Name, Bucket, BasicData, , , , Directory);

    TempFile = GetTempFileName();
    BasicData.Insert("ChunkSize", 200000);

    Result = OPI_S3.GetObject(Name, Bucket, BasicData, , , TempFile);
    # JSON data can also be passed as a path to a .json file
    
    oint s3 GetObject \
     --name "bigfile.exe" \
     --bucket "newbucket2" \
     --basic "{'URL':'storage-155.s3hoster.by','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3','ChunkSize':'200000'}"
Result
NOT JSON: FF D8 FF E1 54 C1 45 78 69 66 00 00 49 49 2A 00 08 00 00 00 0B 00 0E 01 02 00 20 00 00 00 92 00 00 00 0F 01 02 00 05 00 00 00 B2 00 00 00 10 01 02 00 07 00 00 00 B8 00 00 00 12 01 03 00 01 00…