Network.AWS.Env

Environment and AWS specific configuration for the AWS and AWST monads.

Creating the Environment

newEnv

Arguments

:: (Applicative m, MonadIO m, MonadCatch m)

=> Region

Initial region to operate in.

-> Credentials

Credential discovery mechanism.

-> m Env

Creates a new environment with a new Manager without debug logging and uses getAuth to expand/discover the supplied Credentials. Lenses from HasEnv can be used to further configure the resulting Env.

Throws AuthError when environment variables or IAM profiles cannot be read.

See: newEnvWith.

newEnvWith

Arguments

:: (Applicative m, MonadIO m, MonadCatch m)

=> Region

Initial region to operate in.

-> Credentials

Credential discovery mechanism.

-> Maybe Bool

Preload memoisation for the underlying EC2 instance check.

-> Manager

-> m Env

See: newEnv

Throws AuthError when environment variables or IAM profiles cannot be read.

data Env

The environment containing the parameters required to make AWS requests.

Constructors

Env

Fields

_envRegion :: !Region

_envLogger :: !Logger

_envRetryCheck :: !(Int -> HttpException -> IO Bool)

_envRetryPolicy :: !(Maybe RetryPolicy)

_envTimeout :: !(Maybe Seconds)

_envManager :: !Manager

_envEC2 :: !(IORef (Maybe Bool))

_envAuth :: !Auth

Instances

ToLog Env

HasEnv Env

Monad m => MonadReader Env (AWST m)

class HasEnv a where

Minimal complete definition

environment

Methods

environment :: Lens' a Env

envRegion :: Lens' a Region

The current region.

envLogger :: Lens' a Logger

The function used to output log messages.

envRetryCheck :: Lens' a (Int -> HttpException -> IO Bool)

The function used to determine if an HttpException should be retried.

envRetryPolicy :: Lens' a (Maybe RetryPolicy)

The RetryPolicy used to determine backoff/on and retry delay/growth.

envTimeout :: Lens' a (Maybe Seconds)

A HTTP response timeout override to apply. This defaults to Nothing, and the timeout selection is outlined below.

Timeouts are chosen by considering:

• This envTimeout, if set.
• The related Service timeout for the sent request if set. (Usually 70s)
• The envManager timeout if set.
• The default ClientRequest timeout. (Approximately 30s)

envManager :: Lens' a Manager

The Manager used to create and manage open HTTP connections.

envAuth :: Lens' a Auth

The credentials used to sign requests for authentication with AWS.

envEC2 :: Getter a (IORef (Maybe Bool))

A memoised predicate for whether the underlying host is an EC2 instance.

Instances

HasEnv Env

Scoped Actions

within :: (MonadReader r m, HasEnv r) => Region -> m a -> m a

Scope an action within the specific Region.

once :: (MonadReader r m, HasEnv r) => m a -> m a

Scope an action such that any retry logic for the Service is ignored and any requests will at most be sent once.

timeout :: (MonadReader r m, HasEnv r) => Seconds -> m a -> m a

Scope an action such that any HTTP response will use this timeout value.