With the S3 adapter, you can create, delete and list buckets of an S3 endpoint, and retrieve contents and status information of a bucket.
Using the putObject operation, you can store an object to a bucket of an S3 endpoint.
There are two ways to define the source of the object to store:
putObject ( bucketName : String, objectName : String, objectData: Blob )
putObject ( bucketName : String, objectName : String, filePath : String )
Using the getObject operation, you can retrieve an object from a bucket of an S3 endpoint. You can get the object data
There are two ways to retrieve object data as a Blob depending on whether the bucket is versioned or not.
getObject ( bucketName : String, objectName : String, objectData: Blob )
getObject ( bucketName : String, objectName : String, version : String, objectData: Blob )
There are two ways to retrieve object data into a file depending on whether the bucket is versioned or not.
getObject ( bucketName : String, objectName : String, filePath : String )
getObject ( bucketName : String, objectName : String, filePath : String, version : String )
If the file path is not valid, an exception will be thrown.
Using the listObjects operation of the S3 adapter, you can get a list of all objects that are contained in the given bucket.
Using the deleteObject operation of the S3 adapter, you can delete an object from a bucket. The deletion handling differs depending on if the bucket is versioned or not.
If the bucket you want to delete an object from is not versioned, the object is simply deleted. There is no error reported if the object is not existing in the bucket.
If the bucket you want to delete an object from is versioned, you can provide a version identifier with the call.
Using the copyObject operation of the S3 adapter, you can copy an object from one bucket to another.
Using the objectStatus operation of the S3 adapter, you can get some general information on the object including a list of all object versions if the bucket is versioned.
The returned status information has the following structure: