Send a data type which is an instance of AWSRequest, returning it's associated Rs response type.

This will throw any HTTPException or AWSServiceError returned by the service using the MonadError instance. In the case of AWST this will cause the internal ExceptT to short-circuit and return an Error in the Left case as the result of the computation.

See: sendCatch

A variant of send which discards any successful response.

See: send

Send a data type which is an instance of AWSRequest, returning either the associated Rs response type in the success case, or the related service's Er type in the error case.

This includes HTTPExceptions, serialisation errors, and any service errors returned as part of the Response.

Note: Requests will be retried depending upon each service's respective strategy. This can be overriden using once or envRetry. Requests which contain streaming request bodies (such as S3's PutObject) are never considered for retries.

Send a data type which is an instance of AWSPager and paginate while there are more results as defined by the related service operation.

Errors will be handle identically to send.

Note: The ResumableSource will close when there are no more results or the ResourceT computation is unwrapped. See: runResourceT for more information.

See: paginateCatch

Send a data type which is an instance of AWSPager and paginate over the associated Rs response type in the success case, or the related service's Er type in the error case.

Note: The ResumableSource will close when there are no more results or the ResourceT computation is unwrapped. See: runResourceT for more information.

Poll the API until a predfined condition is fulfilled using the supplied Wait specification from the respective service.

Any errors which are unhandled by the Wait specification during retries will be thrown in the same manner as send.

See: awaitCatch

Poll the API until a predfined condition is fulfilled using the supplied Wait specification from the respective service.

The response will be either the first error returned that is not handled by the specification, or the successful response from the await request.

Note: You can find any available Wait specifications under the namespace Network.AWS.ServiceName.Waiters for supported services.

Presign an HTTP request that expires at the specified amount of time in the future.

Note: Requires the service's signer to be an instance of AWSPresigner. Not all signing process support this.

Presign a URL that expires at the specified amount of time in the future.

See: presign

A convenient alias for AWST IO.

The transformer. This satisfies all of the constraints that the functions in this module require, such as providing MonadResource instances, and keeping track of the Env environment.

The MonadError instance for this transformer internally uses ExceptT to handle actions that result in an Error. For more information see sendCatch and paginateCatch.

Provides an alias for shortening type signatures if preferred.

Note: requires the ConstraintKinds extension.

Unwrap an AWST transformer, calling all of the registered ResourceT release actions.

Scope a monadic action within the specific Region.

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

The environment containing the parameters required to make AWS requests.

The current region.

The function used to output log messages.

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

The RetryPolicy used to determine backoffon and retry delaygrowth.

The Manager used to create and manage open HTTP connections.

The credentials used to sign requests for authentication with AWS.

This creates a new environment without debug logging and uses getAuth to expand/discover the supplied Credentials.

Lenses such as envLogger can be used to modify the Env with a debug logger.

Create a new environment in the specified Region with silent log output and a new Manager.

Any errors are thrown using error.

See: newEnv for safe Env instantiation.

Determines how authentication information is retrieved.

Explicit access and secret keys.

A session containing the access key, secret key, and a security token.

Retrieve authentication information using the specified Credentials style.

Default access key environment variable.

Default secret key environment variable.

This is a primitive logger which can be used to log messages to a Handle. A more sophisticated logging library such as tinylog or FastLogger should be used in production code.

Use the supplied logger from envLogger to log info messages.

Note: By default, the library does not output Info level messages. Exclusive output is guaranteed via use of this function.

Use the supplied logger from envLogger to log debug messages.

Use the supplied logger from envLogger to log trace messages.

The top-level error type.

Hoist an Either throwing the Left case, and returning the Right.

Throw any AWSError using throwError.

Verify that an AWSError matches the given Prism, otherwise throw the error using throwAWSError.

Verify that an AWSError matches the given Prism, with an additional guard on the result of the Prism.

See: verify

Unsafely construct a RqBody from a source, manually specifying the SHA256 hash and file size.

Unsafely construct a RqBody from a Handle, manually specifying the SHA256 hash and file size.

Unsafely construct a RqBody from a FilePath, manually specifying the SHA256 hash and file size.

Safely construct a RqBody from a FilePath, calculating the SHA256 hash and file size.

Note: While this function will perform in constant space, it will read the entirety of the file contents _twice_. Firstly to calculate the SHA256 and lastly to stream the contents to the socket during sending.