Download an object from S3

Note that this makes no attempt at reusing a Manager and therefore may not be very efficient for many small requests. See fromS3WithManager for more control over the Manager used.

Download an object from S3 explicitly specifying an aws Configuration, which provides credentials and logging configuration.

Note that this makes no attempt at reusing a Manager and therefore may not be very efficient for many small requests. See fromS3WithManager for more control over the Manager used.

import qualified Aws.Core as Aws

getWholeObject :: MonadSafe m => Bucket -> Object -> Producer BS.ByteString m ()
getWholeObject bucket object = do
    cfg <- liftIO baseConfiguration
    fromS3' cfg defServiceConfig bucket object Nothing

Download an object from S3 explicitly specifying an http-client Manager and aws Configuration (which provides credentials and logging configuration).

This can be more efficient when submitting many small requests as it allows re-use of the Manager across requests. Note that the Manager provided must support TLS; such a manager can be created with

import qualified Aws.Core as Aws
import qualified Network.HTTP.Client as HTTP.Client
import qualified Network.HTTP.Client.TLS as HTTP.Client.TLS

getWholeObject :: MonadSafe m => Bucket -> Object -> Producer BS.ByteString m ()
getWholeObject bucket object = do
    cfg <- liftIO baseConfiguration
    mgr <- liftIO $ newManager tlsManagerSettings
    fromS3WithManager mgr cfg defServiceConfig bucket object Nothing

A byte range within an object.

Thrown when an unknown status code is returned from an S3 download request.