Initializing help system before first use

s3getobjectmetadata

s3getobjectmetadata


Purpose
Requests the meta-data for the given object
Synopsis
function s3getobjectmetadata(bucket:s3bucket, objectkey:text):s3objectmetadata
Arguments
bucket 
The s3bucket object describing the bucket to access
objectkey 
The key of the object to retrieve
Example
declarations
  mymetadata: s3objectmetadata
end-declarations
mymetadata := s3getobjectmetadata(mybucket,"my/file.dat")
if s3status(mybucket)<>S3_OK then
  writeln("Error returned by S3: ",s3getlasterror(mybucket))
  exit(1)
end-if
writeln("my/file.dat last modified: ",mymetadata.lastmodified)
Further information
1. After calling, check the value of s3status for any errors.
2. The procedure will not return until the object metadata has been downloaded or an error detected.
3. If the s3bucket has a configured keyprefix, it will be prepended to the objectkey passed in.
Related topics