API Version 2013-03-31
This package depends on the aws-general package and the aws package. From the latter the it borrows the machinery for managing AWS credentials and making requests. There is also some documentation, including an usage example, in the README of the aws package
Assuming that the Haskell compiler GHC and the Haskell build tool cabal is already installed run the following command from the shell:
cabal install --enable-tests
There are few test cases included in the package. These tests require an AWS account
and AWS credentials stored in the file
~/.aws-keys in the format described in the
documentation of the aws package.
When running these tests some (low) costs may incur for usage of the AWS services.
Therefor the user must explicitly consent to the usage of the AWS credentials by
passing the commandline options
--run-with-aws-credentials to the test application.
In addition the tests require an email address that must be provided with the
command line option
cabal test --test-option=--run-with-aws-credentials --test-option=--test-email=<email-address>
where email address must be replaced with an actual email address.
Here is a very simple example for making a single request to AWS SNS. For more ellaborate usage refer to the documentation of the AWS package.
import Aws import Aws.Core import Aws.General import Aws.Sns import Data.IORef cfg <- Aws.baseConfiguration creds <- Credentials "access-key-id" "secret-access-key" `fmap` newIORef  let snsCfg = SnsConfiguration HTTPS UsWest2 simpleAws cfg snsCfg $ ListTopics Nothing
In order to run the example you must replace
"secret-access-key" with the respective values for your AWS account.
You may also take a look at the test examples in tests/Main.hs.