amazonka

Comprehensive Amazon Web Services SDK.

https://github.com/brendanhay/amazonka

Version on this page:1.6.1@rev:2
LTS Haskell 22.39:2.0@rev:1
Stackage Nightly 2023-12-26:2.0
Latest on Hackage:2.0@rev:1

See all snapshots amazonka appears in

MPL-2.0 licensed by Brendan Hay
Maintained by Brendan Hay
This version can be pinned in stack with:amazonka-1.6.1@sha256:f58b63e83876f93aa03c54e54b3eb8ba9358af93819d41f4a5a8f8b7d8b8399c,3544

Module documentation for 1.6.1

Amazonka

Description

Client library containing request and response logic to communicate with Amazon Web Service compatible APIs. Intended to be used alongside the types supplied by the various amazonka-* service libraries.

Contribute

For any problems, comments, or feedback please create an issue here on GitHub.

Licence

amazonka is released under the Mozilla Public License Version 2.0.

Changes

Change Log

1.6.1

Released: 03 Feb, 2019, Compare: 1.6.0

Fixed

  • Correctly catch exceptions in perform. #464

Changed

  • Add a MonadUnliftIO instance for AWST'. #461
  • Add FromText instances for Int64, String and Seconds. #489
  • Add generalBracket for MonadMask instance on AWST’. #492
  • Remove fractional seconds from serialization of iso8601 timestamps #502

1.6.0

Released: 16 May, 2018, Compare: 1.5.0

Fixed

  • GHC 8.4 compatibility. #456
  • Conduit 1.3 compatibility. #449
  • S3 BucketName now has a FromJSON instance. #452
  • S3 ListObjectsV2 is now named correctly. #447
  • HTTP Expect headers are now stripped when presigning URLs. #444
  • Duplicate generated files no longer exist on case-insensitive file systems. #429
  • EC2 metadata’s instance identity document now has the correct(er) field types. #428
  • OpsWorks DescribeApps and DescribeStacks now correctly handle optional attribute values. #436, #438

Breaking Changes

  • Lambda and other rest-json services with binary response payloads now return a raw ByteString instead of HashMap Text Value, fixing an issue where an empty body could not be deserialized. #428, #428

New Libraries

  • amazonka-alexa-business: Alexa for Business SDK. Overview
  • amazonka-appsync: Automatically update data in web and mobile applications in real time, and updates data for offline users as soon as they reconnect. Overview
  • amazonka-autoscaling-plans: Create instructions to configure dynamic scaling for the scalable resources in your application. Overview
  • amazonka-certificatemanager-pca: Create a secure private certificate authority (CA). Overview
  • amazonka-cloud9: A cloud IDE for writing, running, and debugging code. Overview
  • amazonka-comprehend: Natural language processing (NLP) service that uses machine learning to find insights and relationships in text. Overview
  • amazonka-connect: Simple to use, cloud-based contact center. Overview
  • amazonka-cost-explorer: Dive deeper into your cost and usage data to identify trends, pinpoint cost drivers, and detect anomalies. Overview
  • amazonka-fms: Centrally configure and manage firewall rules across accounts and applications. Overview
  • amazonka-guardduty: Intelligent threat detection and continuous monitoring to protect your AWS accounts and workloads. Overview
  • amazonka-iot-analytics: Analytics for IoT devices. Overview
  • amazonka-iot-jobs-dataplane: Define a set of remote operations that are sent to and executed on one or more devices connected to AWS IoT. Overview
  • amazonka-kinesis-video: Capture, process, and store video streams for analytics and machine learning. Overview
  • amazonka-kinesis-video-media: Media support for Kinesis Video. Overview
  • amazonka-kinesis-video-archived-media: Archived media support for Kinesis Video. Overview
  • amazonka-mediaconvert: Process video files and clips to prepare on-demand content for distribution or archiving. Overview
  • amazonka-medialive: Encode live video for broadcast and streaming to any device. Overview
  • amazonka-mediapackage: Easily prepare and protect video for delivery to Internet devices. Overview
  • amazonka-mediastore: Store and deliver video assets for live streaming media workflows. Overview
  • amazonka-mediastore-dataplane: MediaStore data plane. Overview
  • amazonka-mq: Managed message broker service for Apache ActiveMQ. Overview
  • amazonka-resourcegroups: Resource groups make it easier to manage and automate tasks on large numbers of resources at one time. Overview
  • amazonka-route53-autonaming: Auto naming makes it easier to provision instances for microservices by automating DNS configuration. Overview
  • amazonka-sagemaker: Build, train, and deploy machine learning models at scale. Overview
  • amazonka-sagemaker-runtime: Get inferences from SageMaker models. Overview
  • amazonka-secretsmanager: Easily rotate, manage, and retrieve database credentials, API keys, and other secrets through their lifecycle. Overview
  • amazonka-serverlessrepo: Discover, deploy, and publish serverless applications. Overview
  • amazonka-transcribe: Automatic speech recognition. Overview
  • amazonka-translate: A neural machine translation service that delivers fast, high-quality, and affordable language translation. Overview
  • amazonka-workmail: Secure, managed business email and calendar service with support for existing desktop and mobile email client applications. Overview

Updated Service Definitions

All service definitions and services have been updated and regenerated. Please see each individual library’s commits for a list of changes.

1.5.0

Released: 15 November, 2017, Compare: 1.4.5

Fixed

  • V4 Signing Metadata is now correctly calculated for chunked request bodies. #403
  • DynamoDB Query/Scan pagination will correctly return all available items. #392
  • S3 ReplicationStatus is now parsed correctly. #372
  • OpsWorks LayerAttributes now correctly returns Maybe for Map values. #398
  • newLogger now (correctly) does not set binary mode for any passed handle. #381
  • Improved support for handling S3’s list-type=2 query strings. #391
  • Cabal files now have their license-field changed from OtherLicense to the correct MPL-2.0.

Added

  • Add AWS Signer for V2 Header Authentication. #383
  • Add support for ECS credentials discovery via the ECS container agent. #388
  • Add new regions Montreal (ca-central-1) and London (eu-west-2). #367
  • Add hashedFileRange and chunkedFileRange for preparing request bodies from file ranges. #359

New Libraries

  • amazonka-mobile: Add and configure features for mobile apps, including authentication, data storage, backend logic, push notifications, content delivery, and analytics. Overview
  • amazonka-pricing: Price lists, pricing details, and pricing overview. Overview
  • amazonka-athena: An interactive query service that makes it easy to analyze data in Amazon S3 using standard SQL. Overview
  • amazonka-cloudhsmv2: The newest (incompatible) API of AWS CloudHSM. Overview
  • amazonka-codestar: Use a variety of project templates to start developing applications on Amazon EC2, AWS Lambda, and AWS Elastic Beanstalk. Overview
  • amazonka-dynamodb-dax: DynamoDB Accelerator (DAX) is a fully managed, highly available, in-memory cache for DynamoDB that delivers up to a 10x performance improvement. Overview
  • amazonka-glue: A fully managed extract, transform, and load (ETL) service that makes it easy for customers to prepare and load their data for analytics. Overview
  • amazonka-greengrass: Run local compute, messaging, data caching, and sync capabilities for connected devices in a secure way. Overview
  • amazonka-lex-runtime: Build applications using a speech or text interface powered by the same technology that powers Amazon Alexa. Overview
  • amazonka-lex-models: Build applications using a speech or text interface powered by the same technology that powers Amazon Alexa. Overview
  • amazonka-marketplace-entitlement: Markplace entitlements service. Overview
  • amazonka-resourcegroupstagging: Group and tag AWS resources. Overview

Updated Service Definitions

All service definitions and services have been updated and regenerated. Please see each individual library’s commits for a list of changes.

1.4.5

Released: 04 December, 2016, Compare: 1.4.4

Fixed

  • Generated Haddock documentation is now more readable/consistent. #331
  • Expect: 100-continue HTTP headers are now only added to S3 PutObject requests. #338

Changed

  • Add new regions Ohio (us-east-2) and Seoul (ap-northeast-2). #334
  • The Bombay region has been renamed to Mumbai. #334
  • Route53 HostedZone and DelegateSet identifiers are now stripped, similarly to other SDKs. #336

New Libraries

  • amazonka-xray: Analyze and debug production, distributed applications, such as those built using a microservices architecture. Overview
  • amazonka-stepfunctions: Coordinate the components of distributed applications and microservices using visual workflows. Overview
  • amazonka-ssm: Automate collecting system inventory, applying OS patches, creation of AMIs, and configuring OSes and applications at scale. API Reference
  • amazonka-snowball (+ snowball-edge): Data transport solution using secure appliances to transfer large data into and out of AWS. Overview
  • amazonka-shield: DDoS protection service for web applications using ELB, CloudFront, and Route 53. Overview
  • amazonka-rekognition: Image analysis service for detecting objects, scenes, and faces in images. Overview
  • amazonka-polly: Turn text into lifelike speech. Supports 24 languages and 47 lifelike voices. Overview
  • amazonka-pinpoint: Targeted push notification campaigns to improve engagement in mobile apps. Overview
  • amazonka-opsworks-cm: Managed Chef Automated for OpsWorks. Overview
  • amazonka-lightsail: Launch and manage a virtual private servers. Overview
  • amazonka-health: Personalized service dashboard of your AWS service health. Overview
  • amazonka-codebuild: Continuously build and test your code, paying for what you use. Overview
  • amazonka-appstream (Version 2): Stream desktop applications to any device running a browser. Overview
  • amazonka-budgets: Plan your usage and costs. User Guide
  • amazonka-sms: Automate, schedule, and track incremental replications of live server volumes from on premise to AWS. Overview

Updated Service Definitions

The following services contain a large number of definition updates. Please review the linked commit for each library for specific changes:

1.4.4

Released: 23 October, 2016, Compare: 1.4.3

Fixed #306

  • Kinesis SharedLevelMetrics now correctly deserializes empty responses. #306

Changed

  • newEnv no longer takes Region as a parameter and instead defaults to us-east-1 per other SDK behaviour. The new Env can be configured using the envRegion lens or the within combinator.
  • Region is now discovered via the InstanceIdentity metadata document. #308
  • Region can now be overridden via the AWS_REGION environment variable. #308

1.4.3

Released: 09 June, 2016, Compare: 1.4.2

Fixed

  • Additional fixes for APIGateway timestamps. #291
  • CloudWatchLogs FilterLogEvents pagination now correctly returns all results. #296
  • Documentation code samples for IoT, Lambda, and Discovery are now correctly Haddock formatted.

Changed

  • Documentation is now formatted more consistently at the expense of longer line columns.
  • POSIX timestamps no longer have unecessary (and misleading) Text/XML instances.

1.4.2

Released: 03 June, 2016, Compare: 1.4.1

Fixed

  • GHC 8 support. #294
  • APIGateway now correctly parses and encodes ISO8601 formatted timestamps. #291
  • ~/.aws/credentials now correctly parses with leading newlines. #290

Changed

  • SerializeError now contains the unparsed response body. #293

New Libraries

  • amazonka-discovery: Discover on-premises application inventory and dependencies. Overview
  • amazonka-application-autoscaling: General purpose scaling of AWS resources. API Reference

Updated Service Definitions

1.4.1

Released: 09 May, 2016, Compare: 1.4.0

Fixed

  • AutoScaling DescribeAutoScalingInstances response field LaunchConfigurationName is now optional. #281
  • SWF PollForDecisionTask and PollForActivityTask response fields are now optional. #285

Changed

  • NFData instances generated for all eligible types. #283
  • Additional retry cases for HTTP 5XX response codes. c5e494e

Updated Service Definitions

The following services contain a large number of definition updates. Please review the linked commit for each library for specific changes:

New Libraries

  • amazonka-coginito-idp: Cognito Identity Provider.

1.4.0

Released: 21 March, 2016, Compare: 1.3.7

Fixed

  • Host header missing for presigned URLs. #264
  • Set all API Gateway communication to Accept: application/json. #266
  • Override EC2 AttachmentStatus to add "available". #273 #275
  • Allow EC2 DeleteTags to omit the tag value. #270
  • Add Hashable instances for non-streaming types. #267

Updated Service Definitions

The following services contain a large number (3 months worth) of definition updates. Please see the relevant libraries for specific changes:

  • API Gateway
  • AutoScaling
  • CloudFormation
  • CloudFront
  • CloudHSM
  • CloudSearchDomain
  • CloudWatch
  • CloudWatchLogs
  • CodeCommit
  • CodeDeploy
  • Config
  • DeviceFarm
  • DirectConnect
  • DirectoryService
  • DynamoDB
  • EC2
  • ECS
  • EMR
  • IAM
  • IoT
  • Lambda
  • Marketplace Analytics
  • OpsWorks
  • RDS
  • Redshift
  • Route53
  • S3
  • SES
  • SSM
  • STS
  • StorageGateway
  • Web Application Firewall

New Libraries

  • amazonka-certificatemanager: AWS Certificate Manager.
  • amazonka-dms: Database Migration Service.
  • amazonka-ecr: Elastic Container Registry.
  • amazonka-cloudwatch-events: CloudWatch Events.
  • amazonka-gamelift: Amazon GameLift.
  • amazonka-marketplace-metering: AWS Markpletplace Metering.

1.3.7

Released: 18 December, 2015, Compare: 1.3.6

Fixed

  • Fix SWF PollFor{Activity,Decision}Task response deserialisation. #257

Changed

  • The ErrorCode type constructor is now exported. #258
  • Add Bounded instances for all enumerations with stable values. #255
  • The AWS_PROFILE environment variable can now be used to override the default file credentials location. #254

Updated Service Definitions

  • AutoScaling: Updated service definition.
  • CloudFront: GZip support.
  • CloudTrail: Add isMultiRegion flag to various operations.
  • Config: Updated service definition.
  • DirectConnect: Documentation updates.
  • DirectoryService: Updated service definition.
  • EC2: NAT Gateway updates and an updated service definition.
  • IAM: Additional resource types, documentation updates.
  • IoT: Added RegisterCertificate operation.
  • KMS: Updated service definition.
  • RDS: Add enchanced monitoring support, documentation updates.
  • Route53: Updated service definition.
  • SSM: Updated service definition.

1.3.6

Released: 18 November, 2015, Compare: 1.3.5.1

Fixed

  • Upgrading retry dependency to >= 0.7.
  • Fix S3 BucketLocationConstraint type de/serialisation. #249
  • Fix S3 PutBucketACL header vs request body serialisation. #241

Changed

  • await responses now indicate request fulfillment. #245

Updated Services Definitions

  • EC2: Documentation updates.
  • IAM: Documentation updates.
  • ELB: Documentation updates.
  • Kinesis: Waiter updates.
  • RDS: Documentation and type updates.
  • SQS: Documentation updates.
  • STS: Documentation updates.
  • S3: Minor type and operation updates (UploadPart headers).
  • DeviceFarm: Documentation updates.
  • API Gateway: Multiple type, operation, and documentation updates.

1.3.5.1

Released: 18 November, 2015, Compare: 1.3.5

Fixed

  • Fixed ambigiuty issue when using lens >= 4.13
  • Constraining retry < 0.7 to avoid breaking changes.

1.3.5

Released: 27 October, 2015, Compare: 1.3.4

New Libraries

  • amazonka-apigateway: API Gateway Service.

Updated Services Definitions

  • SSM: Multiple additions and documentation updates.
  • DynamoDB: Paginator updates.

1.3.4

Released: 25 October, 2015, Compare: 1.3.3

New Libraries

  • amazonka-iot-dataplane: Internet of Things Data Plane.

Updated Services Definitions

  • AutoScaling: Documentation updates.
  • EC2: Paginator updates.
  • Glacier: Paginator additions.
  • IAM: Paginator, type, and documentation updates.
  • KMS: Multiple type, operation, and documentation updates.
  • S3: Minor type updates. (Server side encryption related.)

1.3.3

Released: 08 October, 2015, Compare: 1.3.2.1

Fixed

  • Fix S3 GetBucketLocation response deserialisation. #228, #237.
  • runResourceT added to documentation example. #232.
  • Add S3 infrequent access storage class. #234, #238

New Libraries

  • amazonka-elasticsearch: ElasticSearch Service.
  • amazonka-inspector: Inspector Service.
  • amazonka-iot: Internet of Things Platform.
  • amazonka-kinesis-firehose: Kinesis Firehose Service.
  • amazonka-marketplace-analytics: Marketplace Commerce Analytics Service.
  • amazonka-waf: Web Application Firewall Service.

Updated Service Definitions

  • CloudFormation: Documentation updates, DescribeAccountLimits operation added.
  • CloudFront: API version 2015-07-27 support.
  • CloudTrail: Documentation updates, various tag operations added.
  • Config: Miscellaneous type and documentation updates
  • EC2: API version 2015-10-01 support, spot blocks support.
  • ElasticBeanStalk: Documentation updates.
  • RDS: Miscellaneous type and documentation updates.
  • SES: Miscellaneous type and documentation updates.
  • WorkSpaces: Volume encryption types added.

1.3.2

Released: 18 September, 2015, Compare: 1.3.1

Fixed

  • Ensure opqaue JSON bodies are handled correctly. #224 #226

Updated Service Definitions

  • EC2: Documentation updates.
  • EFS: Documentation updates.
  • Route53: Inverted, Measured Latency, and Child Health Check updates.
  • CloudWatchLogs
    • InvalidOperationException error matcher added.
    • DescribeExportTasks operation added
    • CreateExportTask operation added
    • CancelExportTask operation added
    • ExportTask, ExportTaskExecutionInfo, ExportTaskStatus types added.
  • S3
    • Infrequent access storage tier updates.
    • GetBucketLifecycle operation removed (deprecated).
    • PutBucketLifecycle operation removed (deprecated).
    • Rule product removed (deprecated).
    • GetbucketLifecycleConfiguration operation added.
    • PutBucketLifecycleConfiguration operation added.
    • BucketLifecycleConfiguration product added.
    • LifecycleRule product added.

1.3.1

Released: 09 September, 2015, Compare: 1.3.0

Fixed

  • Fix S3 ListObject pagination regression. #218
  • Corrected IS08601 timezone de/serialisation. #217
  • Remove required EC2 VPC isDefault member. #214
  • Correctly named MachineLearning CreateDataSourceFromS3. 4805074

Updated Service Definitions

  • DeviceFarm
  • IAM
  • RDS
  • ImportExport
  • Route53
  • CloudWatchLogs
  • Kinesis
  • DataPipeline
  • EFS: Namespace rename from ElasticFileSystem -> EFS.

1.3.0

Released: 03 September, 2015, Compare: 1.2.0.2

Changed

  • Renamed all HTTP status code response lenses from *Status to *ResponseStatus.

Fixed

  • Fix malformed SNS Subscribe request. #209
  • Fix amazonka-core cabal build error due to lax vector constraints. #208
  • Override SQS message attribute type, QueueAttributeName -> MessageAttributeName. #199
  • Re-enable stackage test builds for all service libraries. #170

1.2.0.2

Released: 29 August, 2015, Compare: 1.2.0.1

1.2.0.1

Released: 28 August, 2015, Compare: 1.2.0

1.2.0

Released: 27 August, 2015, Compare: 1.1.0

1.1.0

Released: 21 August, 2015, Compare: 1.0.1

1.0.1

Released: 18 August, 2015, Compare: 1.0.0

1.0.0

Released: 16 August, 2015, Compare: 0.3.6