Initializing help system before first use

s3putobject

Purpose
Copies an object from a local Mosel file to an object in the S3 bucket
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
s3status s3getobject s3getobjectmetadata s3objectmetadata

Parent Topic Subroutines

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.