s3putobject
s3putobject |
Purpose
Synopsis
procedure s3putobject(bucket:s3bucket, objectkey:text, srcfname:text, metadata:s3objectmetadata)
procedure s3putobject(bucket:s3bucket, objectkey:text, srcfname:text)
Arguments
|
bucket
|
The s3bucket object describing the bucket to access
|
|
objectkey
|
The key of the object to write to
|
|
srcfname
|
Filename containing the object content, e.g. "myfile.dat" or "mmsystem.text:filedata"
|
|
metadata
|
Record describing the object meta-data.
|
Example
s3putobject(mybucket,"my/file.dat","mmsystem.text:myfilecontent")
if s3status(mybucket)<>S3_OK then
writeln("Error returned by S3: ",s3getlasterror(mybucket))
exit(1)
end-if
Further information
1. After calling, check the value of
s3status for any errors.
2. The procedure will not return until the object has been uploaded or an error detected.
3. If the s3bucket has a configured keyprefix, it will be prepended to the objectkey passed in.
4. The local file may be opened & read multiple times; this procedure cannot be used with an I/O driver that does not return the same content each time the filename is opened.
5. When you pass an object meta-data record, only some of the fields are sent to the server - see the
s3objectmetadata documentation for full details. In addition, any fields that are empty will not be sent to the server, with the exception of entries in the
usermetadata array
Related topics