amazonka-dynamodb 0.3.6 → 1.0.0

raw patch · 24 files changed

+8795/−6734 lines, 24 filesdep +amazonka-dynamodbdep +amazonka-testdep +bytestringdep ~amazonka-coredep ~basePVP ok

version bump matches the API change (PVP)

Dependencies added: amazonka-dynamodb, amazonka-test, bytestring, lens, tasty, tasty-hunit, text, time, unordered-containers

Dependency ranges changed: amazonka-core, base

API changes (from Hackage documentation)

Files

• README.md +130/−9
• amazonka-dynamodb.cabal +159/−13
• gen/Network/AWS/DynamoDB.hs +484/−39
• gen/Network/AWS/DynamoDB/BatchGetItem.hs +248/−204
• gen/Network/AWS/DynamoDB/BatchWriteItem.hs +250/−222
• gen/Network/AWS/DynamoDB/CreateTable.hs +250/−187
• gen/Network/AWS/DynamoDB/DeleteItem.hs +459/−403
• gen/Network/AWS/DynamoDB/DeleteTable.hs +108/−81
• gen/Network/AWS/DynamoDB/DescribeTable.hs +103/−88
• gen/Network/AWS/DynamoDB/GetItem.hs +208/−184
• gen/Network/AWS/DynamoDB/ListTables.hs +136/−114
• gen/Network/AWS/DynamoDB/PutItem.hs +476/−416
• gen/Network/AWS/DynamoDB/Query.hs +848/−759
• gen/Network/AWS/DynamoDB/Scan.hs +484/−405
• gen/Network/AWS/DynamoDB/Types.hs +360/−2756
• gen/Network/AWS/DynamoDB/Types/Product.hs +2333/−0
• gen/Network/AWS/DynamoDB/Types/Sum.hs +451/−0
• gen/Network/AWS/DynamoDB/UpdateItem.hs +796/−709
• gen/Network/AWS/DynamoDB/UpdateTable.hs +153/−116
• gen/Network/AWS/DynamoDB/Waiters.hs +36/−29
• test/Main.hs +21/−0
• test/Test/AWS/DynamoDB.hs +26/−0
• test/Test/AWS/DynamoDB/Internal.hs +16/−0
• test/Test/AWS/Gen/DynamoDB.hs +260/−0

@@ -1,24 +1,145 @@ # Amazon DynamoDB SDK -> _Warning:_ This is an experimental preview release which is still under heavy development and not intended for public consumption, _caveat emptor_!-+* [Version](#version) * [Description](#description) * [Contribute](#contribute) * [Licence](#licence) ++## Version++`1.0.0`++ ## Description -Amazon DynamoDB is a fully managed NoSQL database service that provides fast-and predictable performance with seamless scalability. You can use Amazon-DynamoDB to create a database table that can store and retrieve any amount of-data, and serve any level of request traffic. Amazon DynamoDB automatically-spreads the data and traffic for the table over a sufficient number of-servers to handle the request capacity specified by the customer and the-amount of data stored, while maintaining consistent and fast performance.+Amazon DynamoDB +__Overview__++This is the Amazon DynamoDB API Reference. This guide provides+descriptions and samples of the low-level DynamoDB API. For information+about DynamoDB application development, see the+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ Amazon DynamoDB Developer Guide>.++Instead of making the requests to the low-level DynamoDB API directly+from your application, we recommend that you use the AWS Software+Development Kits (SDKs). The easy-to-use libraries in the AWS SDKs make+it unnecessary to call the low-level DynamoDB API directly from your+application. The libraries take care of request authentication,+serialization, and connection management. For more information, see+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/UsingAWSSDK.html Using the AWS SDKs with DynamoDB>+in the /Amazon DynamoDB Developer Guide/.++If you decide to code against the low-level DynamoDB API directly, you+will need to write the necessary code to authenticate your requests. For+more information on signing your requests, see+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/API.html Using the DynamoDB API>+in the /Amazon DynamoDB Developer Guide/.++The following are short descriptions of each low-level API action,+organized by function.++__Managing Tables__++-   /CreateTable/ - Creates a table with user-specified provisioned+    throughput settings. You must designate one attribute as the hash+    primary key for the table; you can optionally designate a second+    attribute as the range primary key. DynamoDB creates indexes on+    these key attributes for fast data access. Optionally, you can+    create one or more secondary indexes, which provide fast data access+    using non-key attributes.++-   /DescribeTable/ - Returns metadata for a table, such as table size,+    status, and index information.++-   /UpdateTable/ - Modifies the provisioned throughput settings for a+    table. Optionally, you can modify the provisioned throughput+    settings for global secondary indexes on the table.++-   /ListTables/ - Returns a list of all tables associated with the+    current AWS account and endpoint.++-   /DeleteTable/ - Deletes a table and all of its indexes.++For conceptual information about managing tables, see+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html Working with Tables>+in the /Amazon DynamoDB Developer Guide/.++__Reading Data__++-   /GetItem/ - Returns a set of attributes for the item that has a+    given primary key. By default, /GetItem/ performs an eventually+    consistent read; however, applications can request a strongly+    consistent read instead.++-   /BatchGetItem/ - Performs multiple /GetItem/ requests for data items+    using their primary keys, from one table or multiple tables. The+    response from /BatchGetItem/ has a size limit of 16 MB and returns a+    maximum of 100 items. Both eventually consistent and strongly+    consistent reads can be used.++-   /Query/ - Returns one or more items from a table or a secondary+    index. You must provide a specific hash key value. You can narrow+    the scope of the query using comparison operators against a range+    key value, or on the index key. /Query/ supports either eventual or+    strong consistency. A single response has a size limit of 1 MB.++-   /Scan/ - Reads every item in a table; the result set is eventually+    consistent. You can limit the number of items returned by filtering+    the data attributes, using conditional expressions. /Scan/ can be+    used to enable ad-hoc querying of a table against non-key+    attributes; however, since this is a full table scan without using+    an index, /Scan/ should not be used for any application query use+    case that requires predictable performance.++For conceptual information about reading data, see+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+and+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan Operations>+in the /Amazon DynamoDB Developer Guide/.++__Modifying Data__++-   /PutItem/ - Creates a new item, or replaces an existing item with a+    new item (including all the attributes). By default, if an item in+    the table already exists with the same primary key, the new item+    completely replaces the existing item. You can use conditional+    operators to replace an item only if its attribute values match+    certain conditions, or to insert a new item only if that item+    doesn\'t already exist.++-   /UpdateItem/ - Modifies the attributes of an existing item. You can+    also use conditional operators to perform an update only if the+    item\'s attribute values match certain conditions.++-   /DeleteItem/ - Deletes an item in a table by primary key. You can+    use conditional operators to perform a delete an item only if the+    item\'s attribute values match certain conditions.++-   /BatchWriteItem/ - Performs multiple /PutItem/ and /DeleteItem/+    requests across multiple tables in a single request. A failure of+    any request(s) in the batch will not cause the entire+    /BatchWriteItem/ operation to fail. Supports batches of up to 25+    items to put or delete, with a maximum total request size of 16 MB.++For conceptual information about modifying data, see+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+and+<http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan Operations>+in the /Amazon DynamoDB Developer Guide/.+ Documentation is available via [Hackage](http://hackage.haskell.org/package/amazonka-dynamodb) and the [AWS API Reference](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/Welcome.html). +The types from this library are intended to be used with [amazonka](http://hackage.haskell.org/package/amazonka),+which provides mechanisms for specifying AuthN/AuthZ information and sending requests.++Use of lenses is required for constructing and manipulating types.+This is due to the amount of nesting of AWS types and transparency regarding+de/serialisation into more palatable Haskell values.+The provided lenses should be compatible with any of the major lens libraries+[lens](http://hackage.haskell.org/package/lens) or [lens-family-core](http://hackage.haskell.org/package/lens-family-core).  ## Contribute 

@@ -1,31 +1,147 @@ name:                  amazonka-dynamodb-version:               0.3.6+version:               1.0.0 synopsis:              Amazon DynamoDB SDK. homepage:              https://github.com/brendanhay/amazonka license:               OtherLicense license-file:          LICENSE author:                Brendan Hay maintainer:            Brendan Hay <brendan.g.hay@gmail.com>-copyright:             Copyright (c) 2013-2014 Brendan Hay+copyright:             Copyright (c) 2013-2015 Brendan Hay category:              Network, AWS, Cloud, Distributed Computing build-type:            Simple extra-source-files:    README.md cabal-version:         >= 1.10  description:-    Amazon DynamoDB is a fully managed NoSQL database service that provides fast-    and predictable performance with seamless scalability. You can use Amazon-    DynamoDB to create a database table that can store and retrieve any amount of-    data, and serve any level of request traffic. Amazon DynamoDB automatically-    spreads the data and traffic for the table over a sufficient number of-    servers to handle the request capacity specified by the customer and the-    amount of data stored, while maintaining consistent and fast performance.+    Amazon DynamoDB +    __Overview__++    This is the Amazon DynamoDB API Reference. This guide provides+    descriptions and samples of the low-level DynamoDB API. For information+    about DynamoDB application development, see the+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ Amazon DynamoDB Developer Guide>.++    Instead of making the requests to the low-level DynamoDB API directly+    from your application, we recommend that you use the AWS Software+    Development Kits (SDKs). The easy-to-use libraries in the AWS SDKs make+    it unnecessary to call the low-level DynamoDB API directly from your+    application. The libraries take care of request authentication,+    serialization, and connection management. For more information, see+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/UsingAWSSDK.html Using the AWS SDKs with DynamoDB>+    in the /Amazon DynamoDB Developer Guide/.++    If you decide to code against the low-level DynamoDB API directly, you+    will need to write the necessary code to authenticate your requests. For+    more information on signing your requests, see+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/API.html Using the DynamoDB API>+    in the /Amazon DynamoDB Developer Guide/.++    The following are short descriptions of each low-level API action,+    organized by function.++    __Managing Tables__++    -   /CreateTable/ - Creates a table with user-specified provisioned+        throughput settings. You must designate one attribute as the hash+        primary key for the table; you can optionally designate a second+        attribute as the range primary key. DynamoDB creates indexes on+        these key attributes for fast data access. Optionally, you can+        create one or more secondary indexes, which provide fast data access+        using non-key attributes.++    -   /DescribeTable/ - Returns metadata for a table, such as table size,+        status, and index information.++    -   /UpdateTable/ - Modifies the provisioned throughput settings for a+        table. Optionally, you can modify the provisioned throughput+        settings for global secondary indexes on the table.++    -   /ListTables/ - Returns a list of all tables associated with the+        current AWS account and endpoint.++    -   /DeleteTable/ - Deletes a table and all of its indexes.++    For conceptual information about managing tables, see+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html Working with Tables>+    in the /Amazon DynamoDB Developer Guide/.++    __Reading Data__++    -   /GetItem/ - Returns a set of attributes for the item that has a+        given primary key. By default, /GetItem/ performs an eventually+        consistent read; however, applications can request a strongly+        consistent read instead.++    -   /BatchGetItem/ - Performs multiple /GetItem/ requests for data items+        using their primary keys, from one table or multiple tables. The+        response from /BatchGetItem/ has a size limit of 16 MB and returns a+        maximum of 100 items. Both eventually consistent and strongly+        consistent reads can be used.++    -   /Query/ - Returns one or more items from a table or a secondary+        index. You must provide a specific hash key value. You can narrow+        the scope of the query using comparison operators against a range+        key value, or on the index key. /Query/ supports either eventual or+        strong consistency. A single response has a size limit of 1 MB.++    -   /Scan/ - Reads every item in a table; the result set is eventually+        consistent. You can limit the number of items returned by filtering+        the data attributes, using conditional expressions. /Scan/ can be+        used to enable ad-hoc querying of a table against non-key+        attributes; however, since this is a full table scan without using+        an index, /Scan/ should not be used for any application query use+        case that requires predictable performance.++    For conceptual information about reading data, see+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+    and+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan Operations>+    in the /Amazon DynamoDB Developer Guide/.++    __Modifying Data__++    -   /PutItem/ - Creates a new item, or replaces an existing item with a+        new item (including all the attributes). By default, if an item in+        the table already exists with the same primary key, the new item+        completely replaces the existing item. You can use conditional+        operators to replace an item only if its attribute values match+        certain conditions, or to insert a new item only if that item+        doesn\'t already exist.++    -   /UpdateItem/ - Modifies the attributes of an existing item. You can+        also use conditional operators to perform an update only if the+        item\'s attribute values match certain conditions.++    -   /DeleteItem/ - Deletes an item in a table by primary key. You can+        use conditional operators to perform a delete an item only if the+        item\'s attribute values match certain conditions.++    -   /BatchWriteItem/ - Performs multiple /PutItem/ and /DeleteItem/+        requests across multiple tables in a single request. A failure of+        any request(s) in the batch will not cause the entire+        /BatchWriteItem/ operation to fail. Supports batches of up to 25+        items to put or delete, with a maximum total request size of 16 MB.++    For conceptual information about modifying data, see+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+    and+    <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan Operations>+    in the /Amazon DynamoDB Developer Guide/.     .-    /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/Welcome.html AWS API Reference>+    The types from this library are intended to be used with+    <http://hackage.haskell.org/package/amazonka amazonka>, which provides+    mechanisms for specifying AuthN/AuthZ information and sending requests.     .-    /Warning:/ This is an experimental preview release which is still under-    heavy development and not intended for public consumption, caveat emptor!+    Use of lenses is required for constructing and manipulating types.+    This is due to the amount of nesting of AWS types and transparency regarding+    de/serialisation into more palatable Haskell values.+    The provided lenses should be compatible with any of the major lens libraries+    such as <http://hackage.haskell.org/package/lens lens> or+    <http://hackage.haskell.org/package/lens-family-core lens-family-core>.+    .+    See "Network.AWS.DynamoDB" and the <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/Welcome.html AWS API Reference>+    to get started.  source-repository head     type:     git@@ -56,7 +172,37 @@         , Network.AWS.DynamoDB.Waiters      other-modules:+          Network.AWS.DynamoDB.Types.Product+        , Network.AWS.DynamoDB.Types.Sum      build-depends:-          amazonka-core == 0.3.6.*+          amazonka-core == 1.0.0.*         , base          >= 4.7     && < 5++test-suite amazonka-dynamodb-test+    type:              exitcode-stdio-1.0+    default-language:  Haskell2010+    hs-source-dirs:    test+    main-is:           Main.hs++    ghc-options:       -Wall -threaded++    -- This is not comprehensive if modules have manually been added.+    -- It exists to ensure cabal 'somewhat' detects test module changes.+    other-modules:+          Test.AWS.DynamoDB+        , Test.AWS.Gen.DynamoDB+        , Test.AWS.DynamoDB.Internal++    build-depends:+          amazonka-core == 1.0.0+        , amazonka-test == 1.0.0+        , amazonka-dynamodb == 1.0.0+        , base+        , bytestring+        , lens+        , tasty+        , tasty-hunit+        , text+        , time+        , unordered-containers

@@ -1,52 +1,497 @@+{-# OPTIONS_GHC -fno-warn-unused-imports    #-}+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}++-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | Amazon DynamoDB is a fully managed NoSQL database service that provides fast--- and predictable performance with seamless scalability. You can use Amazon--- DynamoDB to create a database table that can store and retrieve any amount of--- data, and serve any level of request traffic. Amazon DynamoDB automatically--- spreads the data and traffic for the table over a sufficient number of--- servers to handle the request capacity specified by the customer and the--- amount of data stored, while maintaining consistent and fast performance.+-- Amazon DynamoDB+--+-- __Overview__+--+-- This is the Amazon DynamoDB API Reference. This guide provides+-- descriptions and samples of the low-level DynamoDB API. For information+-- about DynamoDB application development, see the+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ Amazon DynamoDB Developer Guide>.+--+-- Instead of making the requests to the low-level DynamoDB API directly+-- from your application, we recommend that you use the AWS Software+-- Development Kits (SDKs). The easy-to-use libraries in the AWS SDKs make+-- it unnecessary to call the low-level DynamoDB API directly from your+-- application. The libraries take care of request authentication,+-- serialization, and connection management. For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/UsingAWSSDK.html Using the AWS SDKs with DynamoDB>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- If you decide to code against the low-level DynamoDB API directly, you+-- will need to write the necessary code to authenticate your requests. For+-- more information on signing your requests, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/API.html Using the DynamoDB API>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- The following are short descriptions of each low-level API action,+-- organized by function.+--+-- __Managing Tables__+--+-- -   /CreateTable/ - Creates a table with user-specified provisioned+--     throughput settings. You must designate one attribute as the hash+--     primary key for the table; you can optionally designate a second+--     attribute as the range primary key. DynamoDB creates indexes on+--     these key attributes for fast data access. Optionally, you can+--     create one or more secondary indexes, which provide fast data access+--     using non-key attributes.+--+-- -   /DescribeTable/ - Returns metadata for a table, such as table size,+--     status, and index information.+--+-- -   /UpdateTable/ - Modifies the provisioned throughput settings for a+--     table. Optionally, you can modify the provisioned throughput+--     settings for global secondary indexes on the table.+--+-- -   /ListTables/ - Returns a list of all tables associated with the+--     current AWS account and endpoint.+--+-- -   /DeleteTable/ - Deletes a table and all of its indexes.+--+-- For conceptual information about managing tables, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html Working with Tables>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- __Reading Data__+--+-- -   /GetItem/ - Returns a set of attributes for the item that has a+--     given primary key. By default, /GetItem/ performs an eventually+--     consistent read; however, applications can request a strongly+--     consistent read instead.+--+-- -   /BatchGetItem/ - Performs multiple /GetItem/ requests for data items+--     using their primary keys, from one table or multiple tables. The+--     response from /BatchGetItem/ has a size limit of 16 MB and returns a+--     maximum of 100 items. Both eventually consistent and strongly+--     consistent reads can be used.+--+-- -   /Query/ - Returns one or more items from a table or a secondary+--     index. You must provide a specific hash key value. You can narrow+--     the scope of the query using comparison operators against a range+--     key value, or on the index key. /Query/ supports either eventual or+--     strong consistency. A single response has a size limit of 1 MB.+--+-- -   /Scan/ - Reads every item in a table; the result set is eventually+--     consistent. You can limit the number of items returned by filtering+--     the data attributes, using conditional expressions. /Scan/ can be+--     used to enable ad-hoc querying of a table against non-key+--     attributes; however, since this is a full table scan without using+--     an index, /Scan/ should not be used for any application query use+--     case that requires predictable performance.+--+-- For conceptual information about reading data, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+-- and+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan Operations>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- __Modifying Data__+--+-- -   /PutItem/ - Creates a new item, or replaces an existing item with a+--     new item (including all the attributes). By default, if an item in+--     the table already exists with the same primary key, the new item+--     completely replaces the existing item. You can use conditional+--     operators to replace an item only if its attribute values match+--     certain conditions, or to insert a new item only if that item+--     doesn\'t already exist.+--+-- -   /UpdateItem/ - Modifies the attributes of an existing item. You can+--     also use conditional operators to perform an update only if the+--     item\'s attribute values match certain conditions.+--+-- -   /DeleteItem/ - Deletes an item in a table by primary key. You can+--     use conditional operators to perform a delete an item only if the+--     item\'s attribute values match certain conditions.+--+-- -   /BatchWriteItem/ - Performs multiple /PutItem/ and /DeleteItem/+--     requests across multiple tables in a single request. A failure of+--     any request(s) in the batch will not cause the entire+--     /BatchWriteItem/ operation to fail. Supports batches of up to 25+--     items to put or delete, with a maximum total request size of 16 MB.+--+-- For conceptual information about modifying data, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+-- and+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan Operations>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/Welcome.html AWS API Reference> module Network.AWS.DynamoDB-    ( module Network.AWS.DynamoDB.BatchGetItem-    , module Network.AWS.DynamoDB.BatchWriteItem-    , module Network.AWS.DynamoDB.CreateTable+    (+    -- * Service+      DynamoDB++    -- * Errors+    -- $errors++    -- ** ProvisionedThroughputExceededException+    , _ProvisionedThroughputExceededException++    -- ** ConditionalCheckFailedException+    , _ConditionalCheckFailedException++    -- ** ItemCollectionSizeLimitExceededException+    , _ItemCollectionSizeLimitExceededException++    -- ** InternalServerError+    , _InternalServerError++    -- ** ResourceNotFoundException+    , _ResourceNotFoundException++    -- ** ResourceInUseException+    , _ResourceInUseException++    -- ** LimitExceededException+    , _LimitExceededException++    -- * Waiters+    -- $waiters++    -- ** TableNotExists+    , tableNotExists++    -- ** TableExists+    , tableExists++    -- * Operations+    -- $operations++    -- ** UpdateItem+    , module Network.AWS.DynamoDB.UpdateItem++    -- ** DeleteItem     , module Network.AWS.DynamoDB.DeleteItem++    -- ** PutItem+    , module Network.AWS.DynamoDB.PutItem++    -- ** DeleteTable     , module Network.AWS.DynamoDB.DeleteTable++    -- ** UpdateTable+    , module Network.AWS.DynamoDB.UpdateTable++    -- ** BatchGetItem+    , module Network.AWS.DynamoDB.BatchGetItem++    -- ** DescribeTable     , module Network.AWS.DynamoDB.DescribeTable++    -- ** GetItem     , module Network.AWS.DynamoDB.GetItem++    -- ** BatchWriteItem+    , module Network.AWS.DynamoDB.BatchWriteItem++    -- ** Scan (Paginated)+    , module Network.AWS.DynamoDB.Scan++    -- ** ListTables (Paginated)     , module Network.AWS.DynamoDB.ListTables-    , module Network.AWS.DynamoDB.PutItem++    -- ** Query (Paginated)     , module Network.AWS.DynamoDB.Query-    , module Network.AWS.DynamoDB.Scan-    , module Network.AWS.DynamoDB.Types-    , module Network.AWS.DynamoDB.UpdateItem-    , module Network.AWS.DynamoDB.UpdateTable-    , module Network.AWS.DynamoDB.Waiters++    -- ** CreateTable+    , module Network.AWS.DynamoDB.CreateTable++    -- * Types++    -- ** AttributeAction+    , AttributeAction (..)++    -- ** ComparisonOperator+    , ComparisonOperator (..)++    -- ** ConditionalOperator+    , ConditionalOperator (..)++    -- ** IndexStatus+    , IndexStatus (..)++    -- ** KeyType+    , KeyType (..)++    -- ** ProjectionType+    , ProjectionType (..)++    -- ** ReturnConsumedCapacity+    , ReturnConsumedCapacity (..)++    -- ** ReturnItemCollectionMetrics+    , ReturnItemCollectionMetrics (..)++    -- ** ReturnValue+    , ReturnValue (..)++    -- ** ScalarAttributeType+    , ScalarAttributeType (..)++    -- ** Select+    , Select (..)++    -- ** StreamViewType+    , StreamViewType (..)++    -- ** TableStatus+    , TableStatus (..)++    -- ** AttributeDefinition+    , AttributeDefinition+    , attributeDefinition+    , adAttributeName+    , adAttributeType++    -- ** AttributeValue+    , AttributeValue+    , attributeValue+    , avL+    , avM+    , avNS+    , avNULL+    , avN+    , avBS+    , avB+    , avSS+    , avS+    , avBOOL++    -- ** AttributeValueUpdate+    , AttributeValueUpdate+    , attributeValueUpdate+    , avuValue+    , avuAction++    -- ** Capacity+    , Capacity+    , capacity+    , cCapacityUnits++    -- ** Condition+    , Condition+    , condition+    , cAttributeValueList+    , cComparisonOperator++    -- ** ConsumedCapacity+    , ConsumedCapacity+    , consumedCapacity+    , ccCapacityUnits+    , ccGlobalSecondaryIndexes+    , ccLocalSecondaryIndexes+    , ccTable+    , ccTableName++    -- ** CreateGlobalSecondaryIndexAction+    , CreateGlobalSecondaryIndexAction+    , createGlobalSecondaryIndexAction+    , cgsiaIndexName+    , cgsiaKeySchema+    , cgsiaProjection+    , cgsiaProvisionedThroughput++    -- ** DeleteGlobalSecondaryIndexAction+    , DeleteGlobalSecondaryIndexAction+    , deleteGlobalSecondaryIndexAction+    , dgsiaIndexName++    -- ** DeleteRequest+    , DeleteRequest+    , deleteRequest+    , drKey++    -- ** ExpectedAttributeValue+    , ExpectedAttributeValue+    , expectedAttributeValue+    , eavAttributeValueList+    , eavExists+    , eavValue+    , eavComparisonOperator++    -- ** GlobalSecondaryIndex+    , GlobalSecondaryIndex+    , globalSecondaryIndex+    , gsiIndexName+    , gsiKeySchema+    , gsiProjection+    , gsiProvisionedThroughput++    -- ** GlobalSecondaryIndexDescription+    , GlobalSecondaryIndexDescription+    , globalSecondaryIndexDescription+    , gsidBackfilling+    , gsidProvisionedThroughput+    , gsidIndexStatus+    , gsidIndexSizeBytes+    , gsidIndexARN+    , gsidKeySchema+    , gsidProjection+    , gsidItemCount+    , gsidIndexName++    -- ** GlobalSecondaryIndexUpdate+    , GlobalSecondaryIndexUpdate+    , globalSecondaryIndexUpdate+    , gsiuCreate+    , gsiuDelete+    , gsiuUpdate++    -- ** ItemCollectionMetrics+    , ItemCollectionMetrics+    , itemCollectionMetrics+    , icmItemCollectionKey+    , icmSizeEstimateRangeGB++    -- ** KeySchemaElement+    , KeySchemaElement+    , keySchemaElement+    , kseAttributeName+    , kseKeyType++    -- ** KeysAndAttributes+    , KeysAndAttributes+    , keysAndAttributes+    , kaaProjectionExpression+    , kaaConsistentRead+    , kaaExpressionAttributeNames+    , kaaAttributesToGet+    , kaaKeys++    -- ** LocalSecondaryIndex+    , LocalSecondaryIndex+    , localSecondaryIndex+    , lsiIndexName+    , lsiKeySchema+    , lsiProjection++    -- ** LocalSecondaryIndexDescription+    , LocalSecondaryIndexDescription+    , localSecondaryIndexDescription+    , lsidIndexSizeBytes+    , lsidIndexARN+    , lsidKeySchema+    , lsidProjection+    , lsidItemCount+    , lsidIndexName++    -- ** Projection+    , Projection+    , projection+    , pProjectionType+    , pNonKeyAttributes++    -- ** ProvisionedThroughput+    , ProvisionedThroughput+    , provisionedThroughput+    , ptReadCapacityUnits+    , ptWriteCapacityUnits++    -- ** ProvisionedThroughputDescription+    , ProvisionedThroughputDescription+    , provisionedThroughputDescription+    , ptdReadCapacityUnits+    , ptdLastDecreaseDateTime+    , ptdWriteCapacityUnits+    , ptdNumberOfDecreasesToday+    , ptdLastIncreaseDateTime++    -- ** PutRequest+    , PutRequest+    , putRequest+    , prItem++    -- ** StreamSpecification+    , StreamSpecification+    , streamSpecification+    , ssStreamEnabled+    , ssStreamViewType++    -- ** TableDescription+    , TableDescription+    , tableDescription+    , tdProvisionedThroughput+    , tdAttributeDefinitions+    , tdLatestStreamARN+    , tdTableSizeBytes+    , tdTableStatus+    , tdTableARN+    , tdKeySchema+    , tdLatestStreamLabel+    , tdGlobalSecondaryIndexes+    , tdLocalSecondaryIndexes+    , tdCreationDateTime+    , tdItemCount+    , tdTableName+    , tdStreamSpecification++    -- ** UpdateGlobalSecondaryIndexAction+    , UpdateGlobalSecondaryIndexAction+    , updateGlobalSecondaryIndexAction+    , ugsiaIndexName+    , ugsiaProvisionedThroughput++    -- ** WriteRequest+    , WriteRequest+    , writeRequest+    , wrPutRequest+    , wrDeleteRequest     ) where -import Network.AWS.DynamoDB.BatchGetItem-import Network.AWS.DynamoDB.BatchWriteItem-import Network.AWS.DynamoDB.CreateTable-import Network.AWS.DynamoDB.DeleteItem-import Network.AWS.DynamoDB.DeleteTable-import Network.AWS.DynamoDB.DescribeTable-import Network.AWS.DynamoDB.GetItem-import Network.AWS.DynamoDB.ListTables-import Network.AWS.DynamoDB.PutItem-import Network.AWS.DynamoDB.Query-import Network.AWS.DynamoDB.Scan-import Network.AWS.DynamoDB.Types-import Network.AWS.DynamoDB.UpdateItem-import Network.AWS.DynamoDB.UpdateTable-import Network.AWS.DynamoDB.Waiters+import           Network.AWS.DynamoDB.BatchGetItem+import           Network.AWS.DynamoDB.BatchWriteItem+import           Network.AWS.DynamoDB.CreateTable+import           Network.AWS.DynamoDB.DeleteItem+import           Network.AWS.DynamoDB.DeleteTable+import           Network.AWS.DynamoDB.DescribeTable+import           Network.AWS.DynamoDB.GetItem+import           Network.AWS.DynamoDB.ListTables+import           Network.AWS.DynamoDB.PutItem+import           Network.AWS.DynamoDB.Query+import           Network.AWS.DynamoDB.Scan+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.UpdateItem+import           Network.AWS.DynamoDB.UpdateTable+import           Network.AWS.DynamoDB.Waiters++{- $errors+Error matchers are designed for use with the functions provided by+<http://hackage.haskell.org/package/lens/docs/Control-Exception-Lens.html Control.Exception.Lens>.+This allows catching (and rethrowing) service specific errors returned+by 'DynamoDB'.+-}++{- $operations+Some AWS operations return results that are incomplete and require subsequent+requests in order to obtain the entire result set. The process of sending+subsequent requests to continue where a previous request left off is called+pagination. For example, the 'ListObjects' operation of Amazon S3 returns up to+1000 objects at a time, and you must send subsequent requests with the+appropriate Marker in order to retrieve the next page of results.++Operations that have an 'AWSPager' instance can transparently perform subsequent+requests, correctly setting Markers and other request facets to iterate through+the entire result set of a truncated API operation. Operations which support+this have an additional note in the documentation.++Many operations have the ability to filter results on the server side. See the+individual operation parameters for details.+-}++{- $waiters+Waiters poll by repeatedly sending a request until some remote success condition+configured by the 'Wait' specification is fulfilled. The 'Wait' specification+determines how many attempts should be made, in addition to delay and retry strategies.+-}

@@ -1,292 +1,336 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.BatchGetItem--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | The /BatchGetItem/ operation returns the attributes of one or more items from--- one or more tables. You identify requested items by primary key.+-- The /BatchGetItem/ operation returns the attributes of one or more items+-- from one or more tables. You identify requested items by primary key. ----- A single operation can retrieve up to 16 MB of data, which can contain as--- many as 100 items. /BatchGetItem/ will return a partial result if the response--- size limit is exceeded, the table's provisioned throughput is exceeded, or an--- internal processing failure occurs. If a partial result is returned, the--- operation returns a value for /UnprocessedKeys/. You can use this value to--- retry the operation starting with the next item to get.+-- A single operation can retrieve up to 16 MB of data, which can contain+-- as many as 100 items. /BatchGetItem/ will return a partial result if the+-- response size limit is exceeded, the table\'s provisioned throughput is+-- exceeded, or an internal processing failure occurs. If a partial result+-- is returned, the operation returns a value for /UnprocessedKeys/. You+-- can use this value to retry the operation starting with the next item to+-- get. ----- For example, if you ask to retrieve 100 items, but each individual item is--- 300 KB in size, the system returns 52 items (so as not to exceed the 16 MB--- limit). It also returns an appropriate /UnprocessedKeys/ value so you can get--- the next page of results. If desired, your application can include its own--- logic to assemble the pages of results into one data set.+-- If you request more than 100 items /BatchGetItem/ will return a+-- /ValidationException/ with the message \"Too many items requested for+-- the BatchGetItem call\". --+-- For example, if you ask to retrieve 100 items, but each individual item+-- is 300 KB in size, the system returns 52 items (so as not to exceed the+-- 16 MB limit). It also returns an appropriate /UnprocessedKeys/ value so+-- you can get the next page of results. If desired, your application can+-- include its own logic to assemble the pages of results into one data+-- set.+-- -- If /none/ of the items can be processed due to insufficient provisioned--- throughput on all of the tables in the request, then /BatchGetItem/ will return--- a /ProvisionedThroughputExceededException/. If /at least one/ of the items is--- successfully processed, then /BatchGetItem/ completes successfully, while--- returning the keys of the unread items in /UnprocessedKeys/.+-- throughput on all of the tables in the request, then /BatchGetItem/ will+-- return a /ProvisionedThroughputExceededException/. If /at least one/ of+-- the items is successfully processed, then /BatchGetItem/ completes+-- successfully, while returning the keys of the unread items in+-- /UnprocessedKeys/. -- -- If DynamoDB returns any unprocessed items, you should retry the batch--- operation on those items. However, /we strongly recommend that you use anexponential backoff algorithm/. If you retry the batch operation immediately,--- the underlying read or write requests can still fail due to throttling on the--- individual tables. If you delay the batch operation using exponential--- backoff, the individual requests in the batch are much more likely to succeed.+-- operation on those items. However, /we strongly recommend that you use+-- an exponential backoff algorithm/. If you retry the batch operation+-- immediately, the underlying read or write requests can still fail due to+-- throttling on the individual tables. If you delay the batch operation+-- using exponential backoff, the individual requests in the batch are much+-- more likely to succeed. ----- For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations Batch Operations and Error Handling> in the /AmazonDynamoDB Developer Guide/.+-- For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations Batch Operations and Error Handling>+-- in the /Amazon DynamoDB Developer Guide/. -- -- By default, /BatchGetItem/ performs eventually consistent reads on every--- table in the request. If you want strongly consistent reads instead, you can--- set /ConsistentRead/ to 'true' for any or all tables.+-- table in the request. If you want strongly consistent reads instead, you+-- can set /ConsistentRead/ to 'true' for any or all tables. -- -- In order to minimize response latency, /BatchGetItem/ retrieves items in -- parallel. ----- When designing your application, keep in mind that DynamoDB does not return--- attributes in any particular order. To help parse the response by item,--- include the primary key values for the items in your request in the /AttributesToGet/ parameter.+-- When designing your application, keep in mind that DynamoDB does not+-- return attributes in any particular order. To help parse the response by+-- item, include the primary key values for the items in your request in+-- the /AttributesToGet/ parameter. -- -- If a requested item does not exist, it is not returned in the result. -- Requests for nonexistent items consume the minimum read capacity units--- according to the type of read. For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#CapacityUnitCalculations Capacity UnitsCalculations> in the /Amazon DynamoDB Developer Guide/.+-- according to the type of read. For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#CapacityUnitCalculations Capacity Units Calculations>+-- in the /Amazon DynamoDB Developer Guide/. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchGetItem.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchGetItem.html AWS API Reference> for BatchGetItem. module Network.AWS.DynamoDB.BatchGetItem     (-    -- * Request-      BatchGetItem-    -- ** Request constructor-    , batchGetItem-    -- ** Request lenses-    , bgiRequestItems+    -- * Creating a Request+      batchGetItem+    , BatchGetItem+    -- * Request Lenses     , bgiReturnConsumedCapacity+    , bgiRequestItems -    -- * Response-    , BatchGetItemResponse-    -- ** Response constructor+    -- * Destructuring the Response     , batchGetItemResponse-    -- ** Response lenses-    , bgirConsumedCapacity-    , bgirResponses-    , bgirUnprocessedKeys+    , BatchGetItemResponse+    -- * Response Lenses+    , bgirsUnprocessedKeys+    , bgirsResponses+    , bgirsConsumedCapacity+    , bgirsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data BatchGetItem = BatchGetItem-    { _bgiRequestItems           :: Map Text KeysAndAttributes-    , _bgiReturnConsumedCapacity :: Maybe ReturnConsumedCapacity-    } deriving (Eq, Read, Show)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'BatchGetItem' constructor.+-- | Represents the input of a /BatchGetItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'batchGetItem' smart constructor.+data BatchGetItem = BatchGetItem'+    { _bgiReturnConsumedCapacity :: !(Maybe ReturnConsumedCapacity)+    , _bgiRequestItems           :: !(Map Text KeysAndAttributes)+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'BatchGetItem' with the minimum fields required to make a request. ----- * 'bgiRequestItems' @::@ 'HashMap' 'Text' 'KeysAndAttributes'+-- Use one of the following lenses to modify other fields as desired: ----- * 'bgiReturnConsumedCapacity' @::@ 'Maybe' 'ReturnConsumedCapacity'+-- * 'bgiReturnConsumedCapacity' ---batchGetItem :: BatchGetItem-batchGetItem = BatchGetItem-    { _bgiRequestItems           = mempty-    , _bgiReturnConsumedCapacity = Nothing+-- * 'bgiRequestItems'+batchGetItem+    :: BatchGetItem+batchGetItem =+    BatchGetItem'+    { _bgiReturnConsumedCapacity = Nothing+    , _bgiRequestItems = mempty     } --- | A map of one or more table names and, for each table, a map that describes--- one or more items to retrieve from that table. Each table name can be used--- only once per /BatchGetItem/ request.+-- | Undocumented member.+bgiReturnConsumedCapacity :: Lens' BatchGetItem (Maybe ReturnConsumedCapacity)+bgiReturnConsumedCapacity = lens _bgiReturnConsumedCapacity (\ s a -> s{_bgiReturnConsumedCapacity = a});++-- | A map of one or more table names and, for each table, a map that+-- describes one or more items to retrieve from that table. Each table name+-- can be used only once per /BatchGetItem/ request. -- -- Each element in the map of items to retrieve consists of the following: ----- /ConsistentRead/ - If 'true', a strongly consistent read is used; if 'false'--- (the default), an eventually consistent read is used.------ /ExpressionAttributeNames/ - One or more substitution tokens for attribute--- names in the /ProjectionExpression/ parameter. The following are some use cases--- for using /ExpressionAttributeNames/:+-- -   /ConsistentRead/ - If 'true', a strongly consistent read is used; if+--     'false' (the default), an eventually consistent read is used. ----- To access an attribute whose name conflicts with a DynamoDB reserved word.+-- -   /ExpressionAttributeNames/ - One or more substitution tokens for+--     attribute names in the /ProjectionExpression/ parameter. The+--     following are some use cases for using /ExpressionAttributeNames/: ----- To create a placeholder for repeating occurrences of an attribute name in--- an expression.+--     -   To access an attribute whose name conflicts with a DynamoDB+--         reserved word. ----- To prevent special characters in an attribute name from being--- misinterpreted in an expression.+--     -   To create a placeholder for repeating occurrences of an+--         attribute name in an expression. ----- Use the # character in an expression to dereference an attribute name. For--- example, consider the following attribute name:+--     -   To prevent special characters in an attribute name from being+--         misinterpreted in an expression. ----- 'Percentile'+--     Use the __#__ character in an expression to dereference an attribute+--     name. For example, consider the following attribute name: ----- The name of this attribute conflicts with a reserved word, so it cannot be--- used directly in an expression. (For the complete list of reserved words, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words> in the /Amazon DynamoDB Developer Guide/). To work around this,--- you could specify the following for /ExpressionAttributeNames/:+--     -   'Percentile' ----- '{"#P":"Percentile"}'+--     The name of this attribute conflicts with a reserved word, so it+--     cannot be used directly in an expression. (For the complete list of+--     reserved words, see+--     <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words>+--     in the /Amazon DynamoDB Developer Guide/). To work around this, you+--     could specify the following for /ExpressionAttributeNames/: ----- You could then use this substitution in an expression, as in this example:+--     -   '{\"#P\":\"Percentile\"}' ----- '#P = :val'+--     You could then use this substitution in an expression, as in this+--     example: ----- Tokens that begin with the : character are /expression attribute values/,--- which are placeholders for the actual value at runtime.+--     -   '#P = :val' ----- For more information on expression attribute names, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing ItemAttributes> in the /Amazon DynamoDB Developer Guide/.+--     Tokens that begin with the __:__ character are /expression attribute+--     values/, which are placeholders for the actual value at runtime. ----- /Keys/ - An array of primary key attribute values that define specific items--- in the table. For each primary key, you must provide /all/ of the key--- attributes. For example, with a hash type primary key, you only need to--- provide the hash attribute. For a hash-and-range type primary key, you must--- provide /both/ the hash attribute and the range attribute.+--     For more information on expression attribute names, see+--     <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+--     in the /Amazon DynamoDB Developer Guide/. ----- /ProjectionExpression/ - A string that identifies one or more attributes to--- retrieve from the table. These attributes can include scalars, sets, or--- elements of a JSON document. The attributes in the expression must be--- separated by commas.+-- -   /Keys/ - An array of primary key attribute values that define+--     specific items in the table. For each primary key, you must provide+--     /all/ of the key attributes. For example, with a hash type primary+--     key, you only need to provide the hash attribute. For a+--     hash-and-range type primary key, you must provide /both/ the hash+--     attribute and the range attribute. ----- If no attribute names are specified, then all attributes will be returned.--- If any of the requested attributes are not found, they will not appear in the--- result.+-- -   /ProjectionExpression/ - A string that identifies one or more+--     attributes to retrieve from the table. These attributes can include+--     scalars, sets, or elements of a JSON document. The attributes in the+--     expression must be separated by commas. ----- For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes> in the /Amazon DynamoDBDeveloper Guide/.+--     If no attribute names are specified, then all attributes will be+--     returned. If any of the requested attributes are not found, they+--     will not appear in the result. ----- /AttributesToGet/ -+--     For more information, see+--     <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+--     in the /Amazon DynamoDB Developer Guide/. ----- This is a legacy parameter, for backward compatibility. New applications--- should use /ProjectionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.+-- -   /AttributesToGet/ - ----- This parameter allows you to retrieve attributes of type List or Map;--- however, it cannot retrieve individual elements within a List or a Map.+--     This is a legacy parameter, for backward compatibility. New+--     applications should use /ProjectionExpression/ instead. Do not+--     combine legacy parameters and expression parameters in a single API+--     call; otherwise, DynamoDB will return a /ValidationException/+--     exception. ----- The names of one or more attributes to retrieve. If no attribute names are--- provided, then all attributes will be returned. If any of the requested--- attributes are not found, they will not appear in the result.+--     This parameter allows you to retrieve attributes of type List or+--     Map; however, it cannot retrieve individual elements within a List+--     or a Map. ----- Note that /AttributesToGet/ has no effect on provisioned throughput--- consumption. DynamoDB determines capacity units consumed based on item size,--- not on the amount of data that is returned to an application.+--     The names of one or more attributes to retrieve. If no attribute+--     names are provided, then all attributes will be returned. If any of+--     the requested attributes are not found, they will not appear in the+--     result. --+--     Note that /AttributesToGet/ has no effect on provisioned throughput+--     consumption. DynamoDB determines capacity units consumed based on+--     item size, not on the amount of data that is returned to an+--     application. -- bgiRequestItems :: Lens' BatchGetItem (HashMap Text KeysAndAttributes)-bgiRequestItems = lens _bgiRequestItems (\s a -> s { _bgiRequestItems = a }) . _Map+bgiRequestItems = lens _bgiRequestItems (\ s a -> s{_bgiRequestItems = a}) . _Map; -bgiReturnConsumedCapacity :: Lens' BatchGetItem (Maybe ReturnConsumedCapacity)-bgiReturnConsumedCapacity =-    lens _bgiReturnConsumedCapacity-        (\s a -> s { _bgiReturnConsumedCapacity = a })+instance AWSRequest BatchGetItem where+        type Sv BatchGetItem = DynamoDB+        type Rs BatchGetItem = BatchGetItemResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 BatchGetItemResponse' <$>+                   (x .?> "UnprocessedKeys" .!@ mempty) <*>+                     (x .?> "Responses" .!@ mempty)+                     <*> (x .?> "ConsumedCapacity" .!@ mempty)+                     <*> (pure (fromEnum s))) -data BatchGetItemResponse = BatchGetItemResponse-    { _bgirConsumedCapacity :: List "ConsumedCapacity" ConsumedCapacity-    , _bgirResponses        :: Map Text (List "Responses" (Map Text AttributeValue))-    , _bgirUnprocessedKeys  :: Map Text KeysAndAttributes-    } deriving (Eq, Read, Show)+instance ToHeaders BatchGetItem where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.BatchGetItem" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) --- | 'BatchGetItemResponse' constructor.+instance ToJSON BatchGetItem where+        toJSON BatchGetItem'{..}+          = object+              ["ReturnConsumedCapacity" .=+                 _bgiReturnConsumedCapacity,+               "RequestItems" .= _bgiRequestItems]++instance ToPath BatchGetItem where+        toPath = const "/"++instance ToQuery BatchGetItem where+        toQuery = const mempty++-- | Represents the output of a /BatchGetItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'batchGetItemResponse' smart constructor.+data BatchGetItemResponse = BatchGetItemResponse'+    { _bgirsUnprocessedKeys  :: !(Maybe (Map Text KeysAndAttributes))+    , _bgirsResponses        :: !(Maybe (Map Text [Map Text AttributeValue]))+    , _bgirsConsumedCapacity :: !(Maybe [ConsumedCapacity])+    , _bgirsStatus           :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'BatchGetItemResponse' with the minimum fields required to make a request. ----- * 'bgirConsumedCapacity' @::@ ['ConsumedCapacity']+-- Use one of the following lenses to modify other fields as desired: ----- * 'bgirResponses' @::@ 'HashMap' 'Text' ['HashMap' 'Text' 'AttributeValue']+-- * 'bgirsUnprocessedKeys' ----- * 'bgirUnprocessedKeys' @::@ 'HashMap' 'Text' 'KeysAndAttributes'+-- * 'bgirsResponses' ---batchGetItemResponse :: BatchGetItemResponse-batchGetItemResponse = BatchGetItemResponse-    { _bgirResponses        = mempty-    , _bgirUnprocessedKeys  = mempty-    , _bgirConsumedCapacity = mempty+-- * 'bgirsConsumedCapacity'+--+-- * 'bgirsStatus'+batchGetItemResponse+    :: Int -- ^ 'bgirsStatus'+    -> BatchGetItemResponse+batchGetItemResponse pStatus_ =+    BatchGetItemResponse'+    { _bgirsUnprocessedKeys = Nothing+    , _bgirsResponses = Nothing+    , _bgirsConsumedCapacity = Nothing+    , _bgirsStatus = pStatus_     } --- | The read capacity units consumed by the operation.+-- | A map of tables and their respective keys that were not processed with+-- the current response. The /UnprocessedKeys/ value is in the same form as+-- /RequestItems/, so the value can be provided directly to a subsequent+-- /BatchGetItem/ operation. For more information, see /RequestItems/ in+-- the Request Parameters section. -- -- Each element consists of: ----- /TableName/ - The table that consumed the provisioned throughput.+-- -   /Keys/ - An array of primary key attribute values that define+--     specific items in the table. ----- /CapacityUnits/ - The total number of capacity units consumed.+-- -   /AttributesToGet/ - One or more attributes to be retrieved from the+--     table or index. By default, all attributes are returned. If a+--     requested attribute is not found, it does not appear in the result. --+-- -   /ConsistentRead/ - The consistency of a read operation. If set to+--     'true', then a strongly consistent read is used; otherwise, an+--     eventually consistent read is used. ---bgirConsumedCapacity :: Lens' BatchGetItemResponse [ConsumedCapacity]-bgirConsumedCapacity =-    lens _bgirConsumedCapacity (\s a -> s { _bgirConsumedCapacity = a })-        . _List+-- If there are no unprocessed keys remaining, the response contains an+-- empty /UnprocessedKeys/ map.+bgirsUnprocessedKeys :: Lens' BatchGetItemResponse (HashMap Text KeysAndAttributes)+bgirsUnprocessedKeys = lens _bgirsUnprocessedKeys (\ s a -> s{_bgirsUnprocessedKeys = a}) . _Default . _Map; --- | A map of table name to a list of items. Each object in /Responses/ consists of--- a table name, along with a map of attribute data consisting of the data type--- and attribute value.-bgirResponses :: Lens' BatchGetItemResponse (HashMap Text [HashMap Text AttributeValue])-bgirResponses = lens _bgirResponses (\s a -> s { _bgirResponses = a }) . _Map+-- | A map of table name to a list of items. Each object in /Responses/+-- consists of a table name, along with a map of attribute data consisting+-- of the data type and attribute value.+bgirsResponses :: Lens' BatchGetItemResponse (HashMap Text [HashMap Text AttributeValue])+bgirsResponses = lens _bgirsResponses (\ s a -> s{_bgirsResponses = a}) . _Default . _Map; --- | A map of tables and their respective keys that were not processed with the--- current response. The /UnprocessedKeys/ value is in the same form as /RequestItems/, so the value can be provided directly to a subsequent /BatchGetItem/--- operation. For more information, see /RequestItems/ in the Request Parameters--- section.+-- | The read capacity units consumed by the operation. -- -- Each element consists of: ----- /Keys/ - An array of primary key attribute values that define specific items--- in the table.------ /AttributesToGet/ - One or more attributes to be retrieved from the table or--- index. By default, all attributes are returned. If a requested attribute is--- not found, it does not appear in the result.+-- -   /TableName/ - The table that consumed the provisioned throughput. ----- /ConsistentRead/ - The consistency of a read operation. If set to 'true', then--- a strongly consistent read is used; otherwise, an eventually consistent read--- is used.+-- -   /CapacityUnits/ - The total number of capacity units consumed. ----- If there are no unprocessed keys remaining, the response contains an empty /UnprocessedKeys/ map.-bgirUnprocessedKeys :: Lens' BatchGetItemResponse (HashMap Text KeysAndAttributes)-bgirUnprocessedKeys =-    lens _bgirUnprocessedKeys (\s a -> s { _bgirUnprocessedKeys = a })-        . _Map--instance ToPath BatchGetItem where-    toPath = const "/"--instance ToQuery BatchGetItem where-    toQuery = const mempty--instance ToHeaders BatchGetItem--instance ToJSON BatchGetItem where-    toJSON BatchGetItem{..} = object-        [ "RequestItems"           .= _bgiRequestItems-        , "ReturnConsumedCapacity" .= _bgiReturnConsumedCapacity-        ]--instance AWSRequest BatchGetItem where-    type Sv BatchGetItem = DynamoDB-    type Rs BatchGetItem = BatchGetItemResponse--    request  = post "BatchGetItem"-    response = jsonResponse+bgirsConsumedCapacity :: Lens' BatchGetItemResponse [ConsumedCapacity]+bgirsConsumedCapacity = lens _bgirsConsumedCapacity (\ s a -> s{_bgirsConsumedCapacity = a}) . _Default . _Coerce; -instance FromJSON BatchGetItemResponse where-    parseJSON = withObject "BatchGetItemResponse" $ \o -> BatchGetItemResponse-        <$> o .:? "ConsumedCapacity" .!= mempty-        <*> o .:? "Responses" .!= mempty-        <*> o .:? "UnprocessedKeys" .!= mempty+-- | The response status code.+bgirsStatus :: Lens' BatchGetItemResponse Int+bgirsStatus = lens _bgirsStatus (\ s a -> s{_bgirsStatus = a});

@@ -1,309 +1,337 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.BatchWriteItem--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | The /BatchWriteItem/ operation puts or deletes multiple items in one or more--- tables. A single call to /BatchWriteItem/ can write up to 16 MB of data, which--- can comprise as many as 25 put or delete requests. Individual items to be--- written can be as large as 400 KB.+-- The /BatchWriteItem/ operation puts or deletes multiple items in one or+-- more tables. A single call to /BatchWriteItem/ can write up to 16 MB of+-- data, which can comprise as many as 25 put or delete requests.+-- Individual items to be written can be as large as 400 KB. ----- /BatchWriteItem/ cannot update items. To update items, use the /UpdateItem/ API.+-- /BatchWriteItem/ cannot update items. To update items, use the+-- /UpdateItem/ API. ----- The individual /PutItem/ and /DeleteItem/ operations specified in /BatchWriteItem/--- are atomic; however /BatchWriteItem/ as a whole is not. If any requested--- operations fail because the table's provisioned throughput is exceeded or an--- internal processing failure occurs, the failed operations are returned in the /UnprocessedItems/ response parameter. You can investigate and optionally--- resend the requests. Typically, you would call /BatchWriteItem/ in a loop. Each--- iteration would check for unprocessed items and submit a new /BatchWriteItem/--- request with those unprocessed items until all items have been processed.+-- The individual /PutItem/ and /DeleteItem/ operations specified in+-- /BatchWriteItem/ are atomic; however /BatchWriteItem/ as a whole is not.+-- If any requested operations fail because the table\'s provisioned+-- throughput is exceeded or an internal processing failure occurs, the+-- failed operations are returned in the /UnprocessedItems/ response+-- parameter. You can investigate and optionally resend the requests.+-- Typically, you would call /BatchWriteItem/ in a loop. Each iteration+-- would check for unprocessed items and submit a new /BatchWriteItem/+-- request with those unprocessed items until all items have been+-- processed. -- -- Note that if /none/ of the items can be processed due to insufficient--- provisioned throughput on all of the tables in the request, then /BatchWriteItem/ will return a /ProvisionedThroughputExceededException/.+-- provisioned throughput on all of the tables in the request, then+-- /BatchWriteItem/ will return a /ProvisionedThroughputExceededException/. -- -- If DynamoDB returns any unprocessed items, you should retry the batch--- operation on those items. However, /we strongly recommend that you use anexponential backoff algorithm/. If you retry the batch operation immediately,--- the underlying read or write requests can still fail due to throttling on the--- individual tables. If you delay the batch operation using exponential--- backoff, the individual requests in the batch are much more likely to succeed.+-- operation on those items. However, /we strongly recommend that you use+-- an exponential backoff algorithm/. If you retry the batch operation+-- immediately, the underlying read or write requests can still fail due to+-- throttling on the individual tables. If you delay the batch operation+-- using exponential backoff, the individual requests in the batch are much+-- more likely to succeed. ----- For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations Batch Operations and Error Handling> in the /AmazonDynamoDB Developer Guide/.+-- For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations Batch Operations and Error Handling>+-- in the /Amazon DynamoDB Developer Guide/. ----- With /BatchWriteItem/, you can efficiently write or delete large amounts of--- data, such as from Amazon Elastic MapReduce (EMR), or copy data from another--- database into DynamoDB. In order to improve performance with these--- large-scale operations, /BatchWriteItem/ does not behave in the same way as--- individual /PutItem/ and /DeleteItem/ calls would. For example, you cannot--- specify conditions on individual put and delete requests, and /BatchWriteItem/--- does not return deleted items in the response.+-- With /BatchWriteItem/, you can efficiently write or delete large amounts+-- of data, such as from Amazon Elastic MapReduce (EMR), or copy data from+-- another database into DynamoDB. In order to improve performance with+-- these large-scale operations, /BatchWriteItem/ does not behave in the+-- same way as individual /PutItem/ and /DeleteItem/ calls would. For+-- example, you cannot specify conditions on individual put and delete+-- requests, and /BatchWriteItem/ does not return deleted items in the+-- response. ----- If you use a programming language that supports concurrency, such as Java,--- you can use threads to write items in parallel. Your application must include--- the necessary logic to manage the threads. With languages that don't support--- threading, such as PHP, you must update or delete the specified items one at--- a time. In both situations, /BatchWriteItem/ provides an alternative where the--- API performs the specified put and delete operations in parallel, giving you--- the power of the thread pool approach without having to introduce complexity--- into your application.+-- If you use a programming language that supports concurrency, you can use+-- threads to write items in parallel. Your application must include the+-- necessary logic to manage the threads. With languages that don\'t+-- support threading, you must update or delete the specified items one at+-- a time. In both situations, /BatchWriteItem/ provides an alternative+-- where the API performs the specified put and delete operations in+-- parallel, giving you the power of the thread pool approach without+-- having to introduce complexity into your application. -- -- Parallel processing reduces latency, but each specified put and delete -- request consumes the same number of write capacity units whether it is--- processed in parallel or not. Delete operations on nonexistent items consume--- one write capacity unit.------ If one or more of the following is true, DynamoDB rejects the entire batch--- write operation:+-- processed in parallel or not. Delete operations on nonexistent items+-- consume one write capacity unit. ----- One or more tables specified in the /BatchWriteItem/ request does not exist.+-- If one or more of the following is true, DynamoDB rejects the entire+-- batch write operation: ----- Primary key attributes specified on an item in the request do not match--- those in the corresponding table's primary key schema.+-- -   One or more tables specified in the /BatchWriteItem/ request does+--     not exist. ----- You try to perform multiple operations on the same item in the same /BatchWriteItem/ request. For example, you cannot put and delete the same item in the same /BatchWriteItem/ request.+-- -   Primary key attributes specified on an item in the request do not+--     match those in the corresponding table\'s primary key schema. ----- There are more than 25 requests in the batch.+-- -   You try to perform multiple operations on the same item in the same+--     /BatchWriteItem/ request. For example, you cannot put and delete the+--     same item in the same /BatchWriteItem/ request. ----- Any individual item in a batch exceeds 400 KB.+-- -   There are more than 25 requests in the batch. ----- The total request size exceeds 16 MB.+-- -   Any individual item in a batch exceeds 400 KB. --+-- -   The total request size exceeds 16 MB. -- ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchWriteItem.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchWriteItem.html AWS API Reference> for BatchWriteItem. module Network.AWS.DynamoDB.BatchWriteItem     (-    -- * Request-      BatchWriteItem-    -- ** Request constructor-    , batchWriteItem-    -- ** Request lenses-    , bwiRequestItems+    -- * Creating a Request+      batchWriteItem+    , BatchWriteItem+    -- * Request Lenses     , bwiReturnConsumedCapacity     , bwiReturnItemCollectionMetrics+    , bwiRequestItems -    -- * Response-    , BatchWriteItemResponse-    -- ** Response constructor+    -- * Destructuring the Response     , batchWriteItemResponse-    -- ** Response lenses-    , bwirConsumedCapacity-    , bwirItemCollectionMetrics-    , bwirUnprocessedItems+    , BatchWriteItemResponse+    -- * Response Lenses+    , bwirsConsumedCapacity+    , bwirsItemCollectionMetrics+    , bwirsUnprocessedItems+    , bwirsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data BatchWriteItem = BatchWriteItem-    { _bwiRequestItems                :: Map Text (List1 "RequestItems" WriteRequest)-    , _bwiReturnConsumedCapacity      :: Maybe ReturnConsumedCapacity-    , _bwiReturnItemCollectionMetrics :: Maybe ReturnItemCollectionMetrics-    } deriving (Eq, Read, Show)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'BatchWriteItem' constructor.+-- | Represents the input of a /BatchWriteItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'batchWriteItem' smart constructor.+data BatchWriteItem = BatchWriteItem'+    { _bwiReturnConsumedCapacity      :: !(Maybe ReturnConsumedCapacity)+    , _bwiReturnItemCollectionMetrics :: !(Maybe ReturnItemCollectionMetrics)+    , _bwiRequestItems                :: !(Map Text (List1 WriteRequest))+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'BatchWriteItem' with the minimum fields required to make a request. ----- * 'bwiRequestItems' @::@ 'HashMap' 'Text' ('NonEmpty' 'WriteRequest')+-- Use one of the following lenses to modify other fields as desired: ----- * 'bwiReturnConsumedCapacity' @::@ 'Maybe' 'ReturnConsumedCapacity'+-- * 'bwiReturnConsumedCapacity' ----- * 'bwiReturnItemCollectionMetrics' @::@ 'Maybe' 'ReturnItemCollectionMetrics'+-- * 'bwiReturnItemCollectionMetrics' ---batchWriteItem :: BatchWriteItem-batchWriteItem = BatchWriteItem-    { _bwiRequestItems                = mempty-    , _bwiReturnConsumedCapacity      = Nothing+-- * 'bwiRequestItems'+batchWriteItem+    :: BatchWriteItem+batchWriteItem =+    BatchWriteItem'+    { _bwiReturnConsumedCapacity = Nothing     , _bwiReturnItemCollectionMetrics = Nothing+    , _bwiRequestItems = mempty     } --- | A map of one or more table names and, for each table, a list of operations to--- be performed (/DeleteRequest/ or /PutRequest/). Each element in the map consists--- of the following:------ /DeleteRequest/ - Perform a /DeleteItem/ operation on the specified item. The--- item to be deleted is identified by a /Key/ subelement:+-- | Undocumented member.+bwiReturnConsumedCapacity :: Lens' BatchWriteItem (Maybe ReturnConsumedCapacity)+bwiReturnConsumedCapacity = lens _bwiReturnConsumedCapacity (\ s a -> s{_bwiReturnConsumedCapacity = a});++-- | Determines whether item collection metrics are returned. If set to+-- 'SIZE', the response includes statistics about item collections, if any,+-- that were modified during the operation are returned in the response. If+-- set to 'NONE' (the default), no statistics are returned.+bwiReturnItemCollectionMetrics :: Lens' BatchWriteItem (Maybe ReturnItemCollectionMetrics)+bwiReturnItemCollectionMetrics = lens _bwiReturnItemCollectionMetrics (\ s a -> s{_bwiReturnItemCollectionMetrics = a});++-- | A map of one or more table names and, for each table, a list of+-- operations to be performed (/DeleteRequest/ or /PutRequest/). Each+-- element in the map consists of the following: ----- /Key/ - A map of primary key attribute values that uniquely identify the !--- item. Each entry in this map consists of an attribute name and an attribute--- value. For each primary key, you must provide /all/ of the key attributes. For--- example, with a hash type primary key, you only need to provide the hash--- attribute. For a hash-and-range type primary key, you must provide /both/ the--- hash attribute and the range attribute.+-- -   /DeleteRequest/ - Perform a /DeleteItem/ operation on the specified+--     item. The item to be deleted is identified by a /Key/ subelement: ----- /PutRequest/ - Perform a /PutItem/ operation on the specified item. The item--- to be put is identified by an /Item/ subelement:+--     -   /Key/ - A map of primary key attribute values that uniquely+--         identify the ! item. Each entry in this map consists of an+--         attribute name and an attribute value. For each primary key, you+--         must provide /all/ of the key attributes. For example, with a+--         hash type primary key, you only need to provide the hash+--         attribute. For a hash-and-range type primary key, you must+--         provide /both/ the hash attribute and the range attribute. ----- /Item/ - A map of attributes and their values. Each entry in this map--- consists of an attribute name and an attribute value. Attribute values must--- not be null; string and binary type attributes must have lengths greater than--- zero; and set type attributes must not be empty. Requests that contain empty--- values will be rejected with a /ValidationException/ exception.+-- -   /PutRequest/ - Perform a /PutItem/ operation on the specified item.+--     The item to be put is identified by an /Item/ subelement: ----- If you specify any attributes that are part of an index key, then the data--- types for those attributes must match those of the schema in the table's--- attribute definition.+--     -   /Item/ - A map of attributes and their values. Each entry in+--         this map consists of an attribute name and an attribute value.+--         Attribute values must not be null; string and binary type+--         attributes must have lengths greater than zero; and set type+--         attributes must not be empty. Requests that contain empty values+--         will be rejected with a /ValidationException/ exception. --+--         If you specify any attributes that are part of an index key,+--         then the data types for those attributes must match those of the+--         schema in the table\'s attribute definition. -- bwiRequestItems :: Lens' BatchWriteItem (HashMap Text (NonEmpty WriteRequest))-bwiRequestItems = lens _bwiRequestItems (\s a -> s { _bwiRequestItems = a }) . _Map+bwiRequestItems = lens _bwiRequestItems (\ s a -> s{_bwiRequestItems = a}) . _Map; -bwiReturnConsumedCapacity :: Lens' BatchWriteItem (Maybe ReturnConsumedCapacity)-bwiReturnConsumedCapacity =-    lens _bwiReturnConsumedCapacity-        (\s a -> s { _bwiReturnConsumedCapacity = a })+instance AWSRequest BatchWriteItem where+        type Sv BatchWriteItem = DynamoDB+        type Rs BatchWriteItem = BatchWriteItemResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 BatchWriteItemResponse' <$>+                   (x .?> "ConsumedCapacity" .!@ mempty) <*>+                     (x .?> "ItemCollectionMetrics" .!@ mempty)+                     <*> (x .?> "UnprocessedItems" .!@ mempty)+                     <*> (pure (fromEnum s))) --- | A value that if set to 'SIZE', the response includes statistics about item--- collections, if any, that were modified during the operation are returned in--- the response. If set to 'NONE' (the default), no statistics are returned.-bwiReturnItemCollectionMetrics :: Lens' BatchWriteItem (Maybe ReturnItemCollectionMetrics)-bwiReturnItemCollectionMetrics =-    lens _bwiReturnItemCollectionMetrics-        (\s a -> s { _bwiReturnItemCollectionMetrics = a })+instance ToHeaders BatchWriteItem where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.BatchWriteItem" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) -data BatchWriteItemResponse = BatchWriteItemResponse-    { _bwirConsumedCapacity      :: List "ConsumedCapacity" ConsumedCapacity-    , _bwirItemCollectionMetrics :: Map Text (List "ItemCollectionMetrics" ItemCollectionMetrics)-    , _bwirUnprocessedItems      :: Map Text (List1 "UnprocessedItems" WriteRequest)-    } deriving (Eq, Read, Show)+instance ToJSON BatchWriteItem where+        toJSON BatchWriteItem'{..}+          = object+              ["ReturnConsumedCapacity" .=+                 _bwiReturnConsumedCapacity,+               "ReturnItemCollectionMetrics" .=+                 _bwiReturnItemCollectionMetrics,+               "RequestItems" .= _bwiRequestItems] --- | 'BatchWriteItemResponse' constructor.+instance ToPath BatchWriteItem where+        toPath = const "/"++instance ToQuery BatchWriteItem where+        toQuery = const mempty++-- | Represents the output of a /BatchWriteItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'batchWriteItemResponse' smart constructor.+data BatchWriteItemResponse = BatchWriteItemResponse'+    { _bwirsConsumedCapacity      :: !(Maybe [ConsumedCapacity])+    , _bwirsItemCollectionMetrics :: !(Maybe (Map Text [ItemCollectionMetrics]))+    , _bwirsUnprocessedItems      :: !(Maybe (Map Text (List1 WriteRequest)))+    , _bwirsStatus                :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'BatchWriteItemResponse' with the minimum fields required to make a request. ----- * 'bwirConsumedCapacity' @::@ ['ConsumedCapacity']+-- Use one of the following lenses to modify other fields as desired: ----- * 'bwirItemCollectionMetrics' @::@ 'HashMap' 'Text' ['ItemCollectionMetrics']+-- * 'bwirsConsumedCapacity' ----- * 'bwirUnprocessedItems' @::@ 'HashMap' 'Text' ('NonEmpty' 'WriteRequest')+-- * 'bwirsItemCollectionMetrics' ---batchWriteItemResponse :: BatchWriteItemResponse-batchWriteItemResponse = BatchWriteItemResponse-    { _bwirUnprocessedItems      = mempty-    , _bwirItemCollectionMetrics = mempty-    , _bwirConsumedCapacity      = mempty+-- * 'bwirsUnprocessedItems'+--+-- * 'bwirsStatus'+batchWriteItemResponse+    :: Int -- ^ 'bwirsStatus'+    -> BatchWriteItemResponse+batchWriteItemResponse pStatus_ =+    BatchWriteItemResponse'+    { _bwirsConsumedCapacity = Nothing+    , _bwirsItemCollectionMetrics = Nothing+    , _bwirsUnprocessedItems = Nothing+    , _bwirsStatus = pStatus_     }  -- | The capacity units consumed by the operation. -- -- Each element consists of: ----- /TableName/ - The table that consumed the provisioned throughput.------ /CapacityUnits/ - The total number of capacity units consumed.+-- -   /TableName/ - The table that consumed the provisioned throughput. --+-- -   /CapacityUnits/ - The total number of capacity units consumed. ---bwirConsumedCapacity :: Lens' BatchWriteItemResponse [ConsumedCapacity]-bwirConsumedCapacity =-    lens _bwirConsumedCapacity (\s a -> s { _bwirConsumedCapacity = a })-        . _List+bwirsConsumedCapacity :: Lens' BatchWriteItemResponse [ConsumedCapacity]+bwirsConsumedCapacity = lens _bwirsConsumedCapacity (\ s a -> s{_bwirsConsumedCapacity = a}) . _Default . _Coerce; --- | A list of tables that were processed by /BatchWriteItem/ and, for each table,--- information about any item collections that were affected by individual /DeleteItem/ or /PutItem/ operations.+-- | A list of tables that were processed by /BatchWriteItem/ and, for each+-- table, information about any item collections that were affected by+-- individual /DeleteItem/ or /PutItem/ operations. -- -- Each entry consists of the following subelements: ----- /ItemCollectionKey/ - The hash key value of the item collection. This is the--- same as the hash key of the item.------ /SizeEstimateRange/ - An estimate of item collection size, expressed in GB.--- This is a two-element array containing a lower bound and an upper bound for--- the estimate. The estimate includes the size of all the items in the table,--- plus the size of all attributes projected into all of the local secondary--- indexes on the table. Use this estimate to measure whether a local secondary--- index is approaching its size limit.+-- -   /ItemCollectionKey/ - The hash key value of the item collection.+--     This is the same as the hash key of the item. ----- The estimate is subject to change over time; therefore, do not rely on the--- precision or accuracy of the estimate.+-- -   /SizeEstimateRange/ - An estimate of item collection size, expressed+--     in GB. This is a two-element array containing a lower bound and an+--     upper bound for the estimate. The estimate includes the size of all+--     the items in the table, plus the size of all attributes projected+--     into all of the local secondary indexes on the table. Use this+--     estimate to measure whether a local secondary index is approaching+--     its size limit. --+--     The estimate is subject to change over time; therefore, do not rely+--     on the precision or accuracy of the estimate. ---bwirItemCollectionMetrics :: Lens' BatchWriteItemResponse (HashMap Text [ItemCollectionMetrics])-bwirItemCollectionMetrics =-    lens _bwirItemCollectionMetrics-        (\s a -> s { _bwirItemCollectionMetrics = a })-            . _Map+bwirsItemCollectionMetrics :: Lens' BatchWriteItemResponse (HashMap Text [ItemCollectionMetrics])+bwirsItemCollectionMetrics = lens _bwirsItemCollectionMetrics (\ s a -> s{_bwirsItemCollectionMetrics = a}) . _Default . _Map; --- | A map of tables and requests against those tables that were not processed.--- The /UnprocessedItems/ value is in the same form as /RequestItems/, so you can--- provide this value directly to a subsequent /BatchGetItem/ operation. For more--- information, see /RequestItems/ in the Request Parameters section.+-- | A map of tables and requests against those tables that were not+-- processed. The /UnprocessedItems/ value is in the same form as+-- /RequestItems/, so you can provide this value directly to a subsequent+-- /BatchGetItem/ operation. For more information, see /RequestItems/ in+-- the Request Parameters section. ----- Each /UnprocessedItems/ entry consists of a table name and, for that table, a--- list of operations to perform (/DeleteRequest/ or /PutRequest/).+-- Each /UnprocessedItems/ entry consists of a table name and, for that+-- table, a list of operations to perform (/DeleteRequest/ or+-- /PutRequest/). ----- /DeleteRequest/ - Perform a /DeleteItem/ operation on the specified item. The--- item to be deleted is identified by a /Key/ subelement:+-- -   /DeleteRequest/ - Perform a /DeleteItem/ operation on the specified+--     item. The item to be deleted is identified by a /Key/ subelement: ----- /Key/ - A map of primary key attribute values that uniquely identify the--- item. Each entry in this map consists of an attribute name and an attribute--- value.+--     -   /Key/ - A map of primary key attribute values that uniquely+--         identify the item. Each entry in this map consists of an+--         attribute name and an attribute value. ----- /PutRequest/ - Perform a /PutItem/ operation on the specified item. The item--- to be put is identified by an /Item/ subelement:+-- -   /PutRequest/ - Perform a /PutItem/ operation on the specified item.+--     The item to be put is identified by an /Item/ subelement: ----- /Item/ - A map of attributes and their values. Each entry in this map--- consists of an attribute name and an attribute value. Attribute values must--- not be null; string and binary type attributes must have lengths greater than--- zero; and set type attributes must not be empty. Requests that contain empty--- values will be rejected with a /ValidationException/ exception.+--     -   /Item/ - A map of attributes and their values. Each entry in+--         this map consists of an attribute name and an attribute value.+--         Attribute values must not be null; string and binary type+--         attributes must have lengths greater than zero; and set type+--         attributes must not be empty. Requests that contain empty values+--         will be rejected with a /ValidationException/ exception. ----- If you specify any attributes that are part of an index key, then the data--- types for those attributes must match those of the schema in the table's--- attribute definition.+--         If you specify any attributes that are part of an index key,+--         then the data types for those attributes must match those of the+--         schema in the table\'s attribute definition. -- -- If there are no unprocessed items remaining, the response contains an -- empty /UnprocessedItems/ map.-bwirUnprocessedItems :: Lens' BatchWriteItemResponse (HashMap Text (NonEmpty WriteRequest))-bwirUnprocessedItems =-    lens _bwirUnprocessedItems (\s a -> s { _bwirUnprocessedItems = a })-        . _Map--instance ToPath BatchWriteItem where-    toPath = const "/"--instance ToQuery BatchWriteItem where-    toQuery = const mempty--instance ToHeaders BatchWriteItem--instance ToJSON BatchWriteItem where-    toJSON BatchWriteItem{..} = object-        [ "RequestItems"                .= _bwiRequestItems-        , "ReturnConsumedCapacity"      .= _bwiReturnConsumedCapacity-        , "ReturnItemCollectionMetrics" .= _bwiReturnItemCollectionMetrics-        ]--instance AWSRequest BatchWriteItem where-    type Sv BatchWriteItem = DynamoDB-    type Rs BatchWriteItem = BatchWriteItemResponse--    request  = post "BatchWriteItem"-    response = jsonResponse+bwirsUnprocessedItems :: Lens' BatchWriteItemResponse (HashMap Text (NonEmpty WriteRequest))+bwirsUnprocessedItems = lens _bwirsUnprocessedItems (\ s a -> s{_bwirsUnprocessedItems = a}) . _Default . _Map; -instance FromJSON BatchWriteItemResponse where-    parseJSON = withObject "BatchWriteItemResponse" $ \o -> BatchWriteItemResponse-        <$> o .:? "ConsumedCapacity" .!= mempty-        <*> o .:? "ItemCollectionMetrics" .!= mempty-        <*> o .:? "UnprocessedItems" .!= mempty+-- | The response status code.+bwirsStatus :: Lens' BatchWriteItemResponse Int+bwirsStatus = lens _bwirsStatus (\ s a -> s{_bwirsStatus = a});

@@ -1,266 +1,329 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.CreateTable--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | The /CreateTable/ operation adds a new table to your account. In an AWS--- account, table names must be unique within each region. That is, you can have--- two tables with same name if you create the tables in different regions.+-- The /CreateTable/ operation adds a new table to your account. In an AWS+-- account, table names must be unique within each region. That is, you can+-- have two tables with same name if you create the tables in different+-- regions. ----- /CreateTable/ is an asynchronous operation. Upon receiving a /CreateTable/--- request, DynamoDB immediately returns a response with a /TableStatus/ of 'CREATING'. After the table is created, DynamoDB sets the /TableStatus/ to 'ACTIVE'. You--- can perform read and write operations only on an 'ACTIVE' table.+-- /CreateTable/ is an asynchronous operation. Upon receiving a+-- /CreateTable/ request, DynamoDB immediately returns a response with a+-- /TableStatus/ of 'CREATING'. After the table is created, DynamoDB sets+-- the /TableStatus/ to 'ACTIVE'. You can perform read and write operations+-- only on an 'ACTIVE' table. ----- You can optionally define secondary indexes on the new table, as part of the /CreateTable/ operation. If you want to create multiple tables with secondary--- indexes on them, you must create the tables sequentially. Only one table with--- secondary indexes can be in the 'CREATING' state at any given time.+-- You can optionally define secondary indexes on the new table, as part of+-- the /CreateTable/ operation. If you want to create multiple tables with+-- secondary indexes on them, you must create the tables sequentially. Only+-- one table with secondary indexes can be in the 'CREATING' state at any+-- given time. -- -- You can use the /DescribeTable/ API to check the table status. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html AWS API Reference> for CreateTable. module Network.AWS.DynamoDB.CreateTable     (-    -- * Request-      CreateTable-    -- ** Request constructor-    , createTable-    -- ** Request lenses-    , ctAttributeDefinitions+    -- * Creating a Request+      createTable+    , CreateTable+    -- * Request Lenses     , ctGlobalSecondaryIndexes-    , ctKeySchema     , ctLocalSecondaryIndexes-    , ctProvisionedThroughput+    , ctStreamSpecification+    , ctAttributeDefinitions     , ctTableName+    , ctKeySchema+    , ctProvisionedThroughput -    -- * Response-    , CreateTableResponse-    -- ** Response constructor+    -- * Destructuring the Response     , createTableResponse-    -- ** Response lenses-    , ctrTableDescription+    , CreateTableResponse+    -- * Response Lenses+    , ctrsTableDescription+    , ctrsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response -data CreateTable = CreateTable-    { _ctAttributeDefinitions   :: List "AttributeDefinitions" AttributeDefinition-    , _ctGlobalSecondaryIndexes :: List "GlobalSecondaryIndexes" GlobalSecondaryIndex-    , _ctKeySchema              :: List1 "KeySchema" KeySchemaElement-    , _ctLocalSecondaryIndexes  :: List "LocalSecondaryIndexes" LocalSecondaryIndex-    , _ctProvisionedThroughput  :: ProvisionedThroughput-    , _ctTableName              :: Text-    } deriving (Eq, Read, Show)+-- | Represents the input of a /CreateTable/ operation.+--+-- /See:/ 'createTable' smart constructor.+data CreateTable = CreateTable'+    { _ctGlobalSecondaryIndexes :: !(Maybe [GlobalSecondaryIndex])+    , _ctLocalSecondaryIndexes  :: !(Maybe [LocalSecondaryIndex])+    , _ctStreamSpecification    :: !(Maybe StreamSpecification)+    , _ctAttributeDefinitions   :: ![AttributeDefinition]+    , _ctTableName              :: !Text+    , _ctKeySchema              :: !(List1 KeySchemaElement)+    , _ctProvisionedThroughput  :: !ProvisionedThroughput+    } deriving (Eq,Read,Show,Data,Typeable,Generic) --- | 'CreateTable' constructor.+-- | Creates a value of 'CreateTable' with the minimum fields required to make a request. ----- The fields accessible through corresponding lenses are:+-- Use one of the following lenses to modify other fields as desired: ----- * 'ctAttributeDefinitions' @::@ ['AttributeDefinition']+-- * 'ctGlobalSecondaryIndexes' ----- * 'ctGlobalSecondaryIndexes' @::@ ['GlobalSecondaryIndex']+-- * 'ctLocalSecondaryIndexes' ----- * 'ctKeySchema' @::@ 'NonEmpty' 'KeySchemaElement'+-- * 'ctStreamSpecification' ----- * 'ctLocalSecondaryIndexes' @::@ ['LocalSecondaryIndex']+-- * 'ctAttributeDefinitions' ----- * 'ctProvisionedThroughput' @::@ 'ProvisionedThroughput'+-- * 'ctTableName' ----- * 'ctTableName' @::@ 'Text'+-- * 'ctKeySchema' ---createTable :: Text -- ^ 'ctTableName'-            -> NonEmpty KeySchemaElement -- ^ 'ctKeySchema'-            -> ProvisionedThroughput -- ^ 'ctProvisionedThroughput'-            -> CreateTable-createTable p1 p2 p3 = CreateTable-    { _ctTableName              = p1-    , _ctKeySchema              = withIso _List1 (const id) p2-    , _ctProvisionedThroughput  = p3-    , _ctAttributeDefinitions   = mempty-    , _ctLocalSecondaryIndexes  = mempty-    , _ctGlobalSecondaryIndexes = mempty+-- * 'ctProvisionedThroughput'+createTable+    :: Text -- ^ 'ctTableName'+    -> NonEmpty KeySchemaElement -- ^ 'ctKeySchema'+    -> ProvisionedThroughput -- ^ 'ctProvisionedThroughput'+    -> CreateTable+createTable pTableName_ pKeySchema_ pProvisionedThroughput_ =+    CreateTable'+    { _ctGlobalSecondaryIndexes = Nothing+    , _ctLocalSecondaryIndexes = Nothing+    , _ctStreamSpecification = Nothing+    , _ctAttributeDefinitions = mempty+    , _ctTableName = pTableName_+    , _ctKeySchema = _List1 # pKeySchema_+    , _ctProvisionedThroughput = pProvisionedThroughput_     } --- | An array of attributes that describe the key schema for the table and indexes.-ctAttributeDefinitions :: Lens' CreateTable [AttributeDefinition]-ctAttributeDefinitions =-    lens _ctAttributeDefinitions (\s a -> s { _ctAttributeDefinitions = a })-        . _List---- | One or more global secondary indexes (the maximum is five) to be created on--- the table. Each global secondary index in the array includes the following:------ /IndexName/ - The name of the global secondary index. Must be unique only--- for this table.------+-- | One or more global secondary indexes (the maximum is five) to be created+-- on the table. Each global secondary index in the array includes the+-- following: ----- /KeySchema/ - Specifies the key schema for the global secondary index.+-- -   /IndexName/ - The name of the global secondary index. Must be unique+--     only for this table. ----- /Projection/ - Specifies attributes that are copied (projected) from the--- table into the index. These are in addition to the primary key attributes and--- index key attributes, which are automatically projected. Each attribute--- specification is composed of:+-- -   /KeySchema/ - Specifies the key schema for the global secondary+--     index. ----- /ProjectionType/ - One of the following:+-- -   /Projection/ - Specifies attributes that are copied (projected) from+--     the table into the index. These are in addition to the primary key+--     attributes and index key attributes, which are automatically+--     projected. Each attribute specification is composed of: ----- 'KEYS_ONLY' - Only the index and primary keys are projected into the index.+--     -   /ProjectionType/ - One of the following: ----- 'INCLUDE' - Only the specified table attributes are projected into the--- index. The list of projected attributes are in /NonKeyAttributes/.+--         -   'KEYS_ONLY' - Only the index and primary keys are projected+--             into the index. ----- 'ALL' - All of the table attributes are projected into the index.+--         -   'INCLUDE' - Only the specified table attributes are+--             projected into the index. The list of projected attributes+--             are in /NonKeyAttributes/. ----- /NonKeyAttributes/ - A list of one or more non-key attribute names that--- are projected into the secondary index. The total count of attributes--- provided in /NonKeyAttributes/, summed across all of the secondary indexes,--- must not exceed 20. If you project the same attribute into two different--- indexes, this counts as two distinct attributes when determining the total.+--         -   'ALL' - All of the table attributes are projected into the+--             index. ----- /ProvisionedThroughput/ - The provisioned throughput settings for the--- global secondary index, consisting of read and write capacity units.+--     -   /NonKeyAttributes/ - A list of one or more non-key attribute+--         names that are projected into the secondary index. The total+--         count of attributes provided in /NonKeyAttributes/, summed+--         across all of the secondary indexes, must not exceed 20. If you+--         project the same attribute into two different indexes, this+--         counts as two distinct attributes when determining the total. --+-- -   /ProvisionedThroughput/ - The provisioned throughput settings for+--     the global secondary index, consisting of read and write capacity+--     units. -- ctGlobalSecondaryIndexes :: Lens' CreateTable [GlobalSecondaryIndex]-ctGlobalSecondaryIndexes =-    lens _ctGlobalSecondaryIndexes-        (\s a -> s { _ctGlobalSecondaryIndexes = a })-            . _List+ctGlobalSecondaryIndexes = lens _ctGlobalSecondaryIndexes (\ s a -> s{_ctGlobalSecondaryIndexes = a}) . _Default . _Coerce; --- | Specifies the attributes that make up the primary key for a table or an--- index. The attributes in /KeySchema/ must also be defined in the /AttributeDefinitions/ array. For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html Data Model> in the /Amazon DynamoDB DeveloperGuide/.------ Each /KeySchemaElement/ in the array is composed of:------ /AttributeName/ - The name of this key attribute.+-- | One or more local secondary indexes (the maximum is five) to be created+-- on the table. Each index is scoped to a given hash key value. There is a+-- 10 GB size limit per hash key; otherwise, the size of a local secondary+-- index is unconstrained. ----- /KeyType/ - Determines whether the key attribute is 'HASH' or 'RANGE'.+-- Each local secondary index in the array includes the following: ----- For a primary key that consists of a hash attribute, you must provide--- exactly one element with a /KeyType/ of 'HASH'.+-- -   /IndexName/ - The name of the local secondary index. Must be unique+--     only for this table. ----- For a primary key that consists of hash and range attributes, you must--- provide exactly two elements, in this order: The first element must have a /KeyType/ of 'HASH', and the second element must have a /KeyType/ of 'RANGE'.+-- -   /KeySchema/ - Specifies the key schema for the local secondary+--     index. The key schema must begin with the same hash key attribute as+--     the table. ----- For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#WorkingWithTables.primary.key Specifying the Primary Key> in the /Amazon DynamoDBDeveloper Guide/.-ctKeySchema :: Lens' CreateTable (NonEmpty KeySchemaElement)-ctKeySchema = lens _ctKeySchema (\s a -> s { _ctKeySchema = a }) . _List1---- | One or more local secondary indexes (the maximum is five) to be created on--- the table. Each index is scoped to a given hash key value. There is a 10 GB--- size limit per hash key; otherwise, the size of a local secondary index is--- unconstrained.+-- -   /Projection/ - Specifies attributes that are copied (projected) from+--     the table into the index. These are in addition to the primary key+--     attributes and index key attributes, which are automatically+--     projected. Each attribute specification is composed of: ----- Each local secondary index in the array includes the following:+--     -   /ProjectionType/ - One of the following: ----- /IndexName/ - The name of the local secondary index. Must be unique only for--- this table.+--         -   'KEYS_ONLY' - Only the index and primary keys are projected+--             into the index. --+--         -   'INCLUDE' - Only the specified table attributes are+--             projected into the index. The list of projected attributes+--             are in /NonKeyAttributes/. --+--         -   'ALL' - All of the table attributes are projected into the+--             index. ----- /KeySchema/ - Specifies the key schema for the local secondary index. The--- key schema must begin with the same hash key attribute as the table.+--     -   /NonKeyAttributes/ - A list of one or more non-key attribute+--         names that are projected into the secondary index. The total+--         count of attributes provided in /NonKeyAttributes/, summed+--         across all of the secondary indexes, must not exceed 20. If you+--         project the same attribute into two different indexes, this+--         counts as two distinct attributes when determining the total. ----- /Projection/ - Specifies attributes that are copied (projected) from the--- table into the index. These are in addition to the primary key attributes and--- index key attributes, which are automatically projected. Each attribute--- specification is composed of:+ctLocalSecondaryIndexes :: Lens' CreateTable [LocalSecondaryIndex]+ctLocalSecondaryIndexes = lens _ctLocalSecondaryIndexes (\ s a -> s{_ctLocalSecondaryIndexes = a}) . _Default . _Coerce;++-- | The settings for DynamoDB Streams on the table. These settings consist+-- of: ----- /ProjectionType/ - One of the following:+-- -   /StreamEnabled/ - Indicates whether Streams is to be enabled (true)+--     or disabled (false). ----- 'KEYS_ONLY' - Only the index and primary keys are projected into the index.+-- -   /StreamViewType/ - When an item in the table is modified,+--     /StreamViewType/ determines what information is written to the+--     table\'s stream. Valid values for /StreamViewType/ are: ----- 'INCLUDE' - Only the specified table attributes are projected into the--- index. The list of projected attributes are in /NonKeyAttributes/.+--     -   /KEYS_ONLY/ - Only the key attributes of the modified item are+--         written to the stream. ----- 'ALL' - All of the table attributes are projected into the index.+--     -   /NEW_IMAGE/ - The entire item, as it appears after it was+--         modified, is written to the stream. ----- /NonKeyAttributes/ - A list of one or more non-key attribute names that--- are projected into the secondary index. The total count of attributes--- provided in /NonKeyAttributes/, summed across all of the secondary indexes,--- must not exceed 20. If you project the same attribute into two different--- indexes, this counts as two distinct attributes when determining the total.+--     -   /OLD_IMAGE/ - The entire item, as it appeared before it was+--         modified, is written to the stream. --+--     -   /NEW_AND_OLD_IMAGES/ - Both the new and the old item images of+--         the item are written to the stream. ---ctLocalSecondaryIndexes :: Lens' CreateTable [LocalSecondaryIndex]-ctLocalSecondaryIndexes =-    lens _ctLocalSecondaryIndexes (\s a -> s { _ctLocalSecondaryIndexes = a })-        . _List+ctStreamSpecification :: Lens' CreateTable (Maybe StreamSpecification)+ctStreamSpecification = lens _ctStreamSpecification (\ s a -> s{_ctStreamSpecification = a}); -ctProvisionedThroughput :: Lens' CreateTable ProvisionedThroughput-ctProvisionedThroughput =-    lens _ctProvisionedThroughput (\s a -> s { _ctProvisionedThroughput = a })+-- | An array of attributes that describe the key schema for the table and+-- indexes.+ctAttributeDefinitions :: Lens' CreateTable [AttributeDefinition]+ctAttributeDefinitions = lens _ctAttributeDefinitions (\ s a -> s{_ctAttributeDefinitions = a}) . _Coerce;  -- | The name of the table to create. ctTableName :: Lens' CreateTable Text-ctTableName = lens _ctTableName (\s a -> s { _ctTableName = a })--newtype CreateTableResponse = CreateTableResponse-    { _ctrTableDescription :: Maybe TableDescription-    } deriving (Eq, Read, Show)+ctTableName = lens _ctTableName (\ s a -> s{_ctTableName = a}); --- | 'CreateTableResponse' constructor.+-- | Specifies the attributes that make up the primary key for a table or an+-- index. The attributes in /KeySchema/ must also be defined in the+-- /AttributeDefinitions/ array. For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html Data Model>+-- in the /Amazon DynamoDB Developer Guide/. ----- The fields accessible through corresponding lenses are:+-- Each /KeySchemaElement/ in the array is composed of: ----- * 'ctrTableDescription' @::@ 'Maybe' 'TableDescription'+-- -   /AttributeName/ - The name of this key attribute. ---createTableResponse :: CreateTableResponse-createTableResponse = CreateTableResponse-    { _ctrTableDescription = Nothing-    }+-- -   /KeyType/ - Determines whether the key attribute is 'HASH' or+--     'RANGE'.+--+-- For a primary key that consists of a hash attribute, you must provide+-- exactly one element with a /KeyType/ of 'HASH'.+--+-- For a primary key that consists of hash and range attributes, you must+-- provide exactly two elements, in this order: The first element must have+-- a /KeyType/ of 'HASH', and the second element must have a /KeyType/ of+-- 'RANGE'.+--+-- For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#WorkingWithTables.primary.key Specifying the Primary Key>+-- in the /Amazon DynamoDB Developer Guide/.+ctKeySchema :: Lens' CreateTable (NonEmpty KeySchemaElement)+ctKeySchema = lens _ctKeySchema (\ s a -> s{_ctKeySchema = a}) . _List1; -ctrTableDescription :: Lens' CreateTableResponse (Maybe TableDescription)-ctrTableDescription =-    lens _ctrTableDescription (\s a -> s { _ctrTableDescription = a })+-- | Undocumented member.+ctProvisionedThroughput :: Lens' CreateTable ProvisionedThroughput+ctProvisionedThroughput = lens _ctProvisionedThroughput (\ s a -> s{_ctProvisionedThroughput = a}); +instance AWSRequest CreateTable where+        type Sv CreateTable = DynamoDB+        type Rs CreateTable = CreateTableResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 CreateTableResponse' <$>+                   (x .?> "TableDescription") <*> (pure (fromEnum s)))++instance ToHeaders CreateTable where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.CreateTable" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)])++instance ToJSON CreateTable where+        toJSON CreateTable'{..}+          = object+              ["GlobalSecondaryIndexes" .=+                 _ctGlobalSecondaryIndexes,+               "LocalSecondaryIndexes" .= _ctLocalSecondaryIndexes,+               "StreamSpecification" .= _ctStreamSpecification,+               "AttributeDefinitions" .= _ctAttributeDefinitions,+               "TableName" .= _ctTableName,+               "KeySchema" .= _ctKeySchema,+               "ProvisionedThroughput" .= _ctProvisionedThroughput]+ instance ToPath CreateTable where-    toPath = const "/"+        toPath = const "/"  instance ToQuery CreateTable where-    toQuery = const mempty--instance ToHeaders CreateTable+        toQuery = const mempty -instance ToJSON CreateTable where-    toJSON CreateTable{..} = object-        [ "AttributeDefinitions"   .= _ctAttributeDefinitions-        , "TableName"              .= _ctTableName-        , "KeySchema"              .= _ctKeySchema-        , "LocalSecondaryIndexes"  .= _ctLocalSecondaryIndexes-        , "GlobalSecondaryIndexes" .= _ctGlobalSecondaryIndexes-        , "ProvisionedThroughput"  .= _ctProvisionedThroughput-        ]+-- | Represents the output of a /CreateTable/ operation.+--+-- /See:/ 'createTableResponse' smart constructor.+data CreateTableResponse = CreateTableResponse'+    { _ctrsTableDescription :: !(Maybe TableDescription)+    , _ctrsStatus           :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic) -instance AWSRequest CreateTable where-    type Sv CreateTable = DynamoDB-    type Rs CreateTable = CreateTableResponse+-- | Creates a value of 'CreateTableResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'ctrsTableDescription'+--+-- * 'ctrsStatus'+createTableResponse+    :: Int -- ^ 'ctrsStatus'+    -> CreateTableResponse+createTableResponse pStatus_ =+    CreateTableResponse'+    { _ctrsTableDescription = Nothing+    , _ctrsStatus = pStatus_+    } -    request  = post "CreateTable"-    response = jsonResponse+-- | Undocumented member.+ctrsTableDescription :: Lens' CreateTableResponse (Maybe TableDescription)+ctrsTableDescription = lens _ctrsTableDescription (\ s a -> s{_ctrsTableDescription = a}); -instance FromJSON CreateTableResponse where-    parseJSON = withObject "CreateTableResponse" $ \o -> CreateTableResponse-        <$> o .:? "TableDescription"+-- | The response status code.+ctrsStatus :: Lens' CreateTableResponse Int+ctrsStatus = lens _ctrsStatus (\ s a -> s{_ctrsStatus = a});

@@ -1,555 +1,611 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.DeleteItem--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | Deletes a single item in a table by primary key. You can perform a--- conditional delete operation that deletes the item if it exists, or if it has--- an expected attribute value.+-- Deletes a single item in a table by primary key. You can perform a+-- conditional delete operation that deletes the item if it exists, or if+-- it has an expected attribute value. ----- In addition to deleting an item, you can also return the item's attribute--- values in the same operation, using the /ReturnValues/ parameter.+-- In addition to deleting an item, you can also return the item\'s+-- attribute values in the same operation, using the /ReturnValues/+-- parameter. ----- Unless you specify conditions, the /DeleteItem/ is an idempotent operation;--- running it multiple times on the same item or attribute does /not/ result in an--- error response.+-- Unless you specify conditions, the /DeleteItem/ is an idempotent+-- operation; running it multiple times on the same item or attribute does+-- /not/ result in an error response. -- -- Conditional deletes are useful for deleting items only if specific -- conditions are met. If those conditions are met, DynamoDB performs the -- delete. Otherwise, the item is not deleted. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html AWS API Reference> for DeleteItem. module Network.AWS.DynamoDB.DeleteItem     (-    -- * Request-      DeleteItem-    -- ** Request constructor-    , deleteItem-    -- ** Request lenses-    , diConditionExpression-    , diConditionalOperator-    , diExpected+    -- * Creating a Request+      deleteItem+    , DeleteItem+    -- * Request Lenses+    , diReturnValues     , diExpressionAttributeNames-    , diExpressionAttributeValues-    , diKey     , diReturnConsumedCapacity+    , diExpressionAttributeValues     , diReturnItemCollectionMetrics-    , diReturnValues+    , diConditionExpression+    , diConditionalOperator+    , diExpected     , diTableName+    , diKey -    -- * Response-    , DeleteItemResponse-    -- ** Response constructor+    -- * Destructuring the Response     , deleteItemResponse-    -- ** Response lenses-    , dirAttributes-    , dirConsumedCapacity-    , dirItemCollectionMetrics+    , DeleteItemResponse+    -- * Response Lenses+    , dirsConsumedCapacity+    , dirsItemCollectionMetrics+    , dirsAttributes+    , dirsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data DeleteItem = DeleteItem-    { _diConditionExpression         :: Maybe Text-    , _diConditionalOperator         :: Maybe ConditionalOperator-    , _diExpected                    :: Map Text ExpectedAttributeValue-    , _diExpressionAttributeNames    :: Map Text Text-    , _diExpressionAttributeValues   :: Map Text AttributeValue-    , _diKey                         :: Map Text AttributeValue-    , _diReturnConsumedCapacity      :: Maybe ReturnConsumedCapacity-    , _diReturnItemCollectionMetrics :: Maybe ReturnItemCollectionMetrics-    , _diReturnValues                :: Maybe ReturnValue-    , _diTableName                   :: Text-    } deriving (Eq, Read, Show)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'DeleteItem' constructor.+-- | Represents the input of a /DeleteItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'deleteItem' smart constructor.+data DeleteItem = DeleteItem'+    { _diReturnValues                :: !(Maybe ReturnValue)+    , _diExpressionAttributeNames    :: !(Maybe (Map Text Text))+    , _diReturnConsumedCapacity      :: !(Maybe ReturnConsumedCapacity)+    , _diExpressionAttributeValues   :: !(Maybe (Map Text AttributeValue))+    , _diReturnItemCollectionMetrics :: !(Maybe ReturnItemCollectionMetrics)+    , _diConditionExpression         :: !(Maybe Text)+    , _diConditionalOperator         :: !(Maybe ConditionalOperator)+    , _diExpected                    :: !(Maybe (Map Text ExpectedAttributeValue))+    , _diTableName                   :: !Text+    , _diKey                         :: !(Map Text AttributeValue)+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'DeleteItem' with the minimum fields required to make a request. ----- * 'diConditionExpression' @::@ 'Maybe' 'Text'+-- Use one of the following lenses to modify other fields as desired: ----- * 'diConditionalOperator' @::@ 'Maybe' 'ConditionalOperator'+-- * 'diReturnValues' ----- * 'diExpected' @::@ 'HashMap' 'Text' 'ExpectedAttributeValue'+-- * 'diExpressionAttributeNames' ----- * 'diExpressionAttributeNames' @::@ 'HashMap' 'Text' 'Text'+-- * 'diReturnConsumedCapacity' ----- * 'diExpressionAttributeValues' @::@ 'HashMap' 'Text' 'AttributeValue'+-- * 'diExpressionAttributeValues' ----- * 'diKey' @::@ 'HashMap' 'Text' 'AttributeValue'+-- * 'diReturnItemCollectionMetrics' ----- * 'diReturnConsumedCapacity' @::@ 'Maybe' 'ReturnConsumedCapacity'+-- * 'diConditionExpression' ----- * 'diReturnItemCollectionMetrics' @::@ 'Maybe' 'ReturnItemCollectionMetrics'+-- * 'diConditionalOperator' ----- * 'diReturnValues' @::@ 'Maybe' 'ReturnValue'+-- * 'diExpected' ----- * 'diTableName' @::@ 'Text'+-- * 'diTableName' ---deleteItem :: Text -- ^ 'diTableName'-           -> DeleteItem-deleteItem p1 = DeleteItem-    { _diTableName                   = p1-    , _diKey                         = mempty-    , _diExpected                    = mempty-    , _diConditionalOperator         = Nothing-    , _diReturnValues                = Nothing-    , _diReturnConsumedCapacity      = Nothing+-- * 'diKey'+deleteItem+    :: Text -- ^ 'diTableName'+    -> DeleteItem+deleteItem pTableName_ =+    DeleteItem'+    { _diReturnValues = Nothing+    , _diExpressionAttributeNames = Nothing+    , _diReturnConsumedCapacity = Nothing+    , _diExpressionAttributeValues = Nothing     , _diReturnItemCollectionMetrics = Nothing-    , _diConditionExpression         = Nothing-    , _diExpressionAttributeNames    = mempty-    , _diExpressionAttributeValues   = mempty+    , _diConditionExpression = Nothing+    , _diConditionalOperator = Nothing+    , _diExpected = Nothing+    , _diTableName = pTableName_+    , _diKey = mempty     } --- | A condition that must be satisfied in order for a conditional /DeleteItem/ to--- succeed.------ An expression can contain any of the following:------ Boolean functions: 'attribute_exists | attribute_not_exists | contains |begins_with'------ These function names are case-sensitive.------ Comparison operators: ' = | <> | < | > | <= | >= | BETWEEN | IN'------ Logical operators: 'AND | OR | NOT'+-- | Use /ReturnValues/ if you want to get the item attributes as they+-- appeared before they were deleted. For /DeleteItem/, the valid values+-- are: ----- For more information on condition expressions, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>--- in the /Amazon DynamoDB Developer Guide/.+-- -   'NONE' - If /ReturnValues/ is not specified, or if its value is+--     'NONE', then nothing is returned. (This setting is the default for+--     /ReturnValues/.) ----- /ConditionExpression/ replaces the legacy /ConditionalOperator/ and /Expected/--- parameters.+-- -   'ALL_OLD' - The content of the old item is returned. ---diConditionExpression :: Lens' DeleteItem (Maybe Text)-diConditionExpression =-    lens _diConditionExpression (\s a -> s { _diConditionExpression = a })+diReturnValues :: Lens' DeleteItem (Maybe ReturnValue)+diReturnValues = lens _diReturnValues (\ s a -> s{_diReturnValues = a}); --- | This is a legacy parameter, for backward compatibility. New applications--- should use /ConditionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.------ A logical operator to apply to the conditions in the /Expected/ map:------ 'AND' - If all of the conditions evaluate to true, then the entire map--- evaluates to true.+-- | One or more substitution tokens for attribute names in an expression.+-- The following are some use cases for using /ExpressionAttributeNames/: ----- 'OR' - If at least one of the conditions evaluate to true, then the entire map--- evaluates to true.+-- -   To access an attribute whose name conflicts with a DynamoDB reserved+--     word. ----- If you omit /ConditionalOperator/, then 'AND' is the default.+-- -   To create a placeholder for repeating occurrences of an attribute+--     name in an expression. ----- The operation will succeed only if the entire map evaluates to true.+-- -   To prevent special characters in an attribute name from being+--     misinterpreted in an expression. ----- This parameter does not support attributes of type List or Map.+-- Use the __#__ character in an expression to dereference an attribute+-- name. For example, consider the following attribute name: ---diConditionalOperator :: Lens' DeleteItem (Maybe ConditionalOperator)-diConditionalOperator =-    lens _diConditionalOperator (\s a -> s { _diConditionalOperator = a })---- | This is a legacy parameter, for backward compatibility. New applications--- should use /ConditionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.+-- -   'Percentile' ----- A map of attribute/condition pairs. /Expected/ provides a conditional block--- for the /DeleteItem/ operation.+-- The name of this attribute conflicts with a reserved word, so it cannot+-- be used directly in an expression. (For the complete list of reserved+-- words, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words>+-- in the /Amazon DynamoDB Developer Guide/). To work around this, you+-- could specify the following for /ExpressionAttributeNames/: ----- Each element of /Expected/ consists of an attribute name, a comparison--- operator, and one or more values. DynamoDB compares the attribute with the--- value(s) you supplied, using the comparison operator. For each /Expected/--- element, the result of the evaluation is either true or false.+-- -   '{\"#P\":\"Percentile\"}' ----- If you specify more than one element in the /Expected/ map, then by default--- all of the conditions must evaluate to true. In other words, the conditions--- are ANDed together. (You can use the /ConditionalOperator/ parameter to OR the--- conditions instead. If you do this, then at least one of the conditions must--- evaluate to true, rather than all of them.)+-- You could then use this substitution in an expression, as in this+-- example: ----- If the /Expected/ map evaluates to true, then the conditional operation--- succeeds; otherwise, it fails.+-- -   '#P = :val' ----- /Expected/ contains the following:+-- Tokens that begin with the __:__ character are /expression attribute+-- values/, which are placeholders for the actual value at runtime. ----- /AttributeValueList/ - One or more values to evaluate against the supplied--- attribute. The number of values in the list depends on the /ComparisonOperator/--- being used.+-- For more information on expression attribute names, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+-- in the /Amazon DynamoDB Developer Guide/.+diExpressionAttributeNames :: Lens' DeleteItem (HashMap Text Text)+diExpressionAttributeNames = lens _diExpressionAttributeNames (\ s a -> s{_diExpressionAttributeNames = a}) . _Default . _Map;++-- | Undocumented member.+diReturnConsumedCapacity :: Lens' DeleteItem (Maybe ReturnConsumedCapacity)+diReturnConsumedCapacity = lens _diReturnConsumedCapacity (\ s a -> s{_diReturnConsumedCapacity = a});++-- | One or more values that can be substituted in an expression. ----- For type Number, value comparisons are numeric.+-- Use the __:__ (colon) character in an expression to dereference an+-- attribute value. For example, suppose that you wanted to check whether+-- the value of the /ProductStatus/ attribute was one of the following: ----- String value comparisons for greater than, equals, or less than are based on--- ASCII character code values. For example, 'a' is greater than 'A', and 'a' is--- greater than 'B'. For a list of code values, see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>.+-- 'Available | Backordered | Discontinued' ----- For type Binary, DynamoDB treats each byte of the binary data as unsigned--- when it compares binary values.+-- You would first need to specify /ExpressionAttributeValues/ as follows: ----- /ComparisonOperator/ - A comparator for evaluating attributes in the /AttributeValueList/. When performing the comparison, DynamoDB uses strongly consistent reads.+-- '{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }' ----- The following comparison operators are available:+-- You could then use these values in an expression, such as this: ----- 'EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS |BEGINS_WITH | IN | BETWEEN'+-- 'ProductStatus IN (:avail, :back, :disc)' ----- The following are descriptions of each comparison operator.+-- For more information on expression attribute values, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>+-- in the /Amazon DynamoDB Developer Guide/.+diExpressionAttributeValues :: Lens' DeleteItem (HashMap Text AttributeValue)+diExpressionAttributeValues = lens _diExpressionAttributeValues (\ s a -> s{_diExpressionAttributeValues = a}) . _Default . _Map;++-- | Determines whether item collection metrics are returned. If set to+-- 'SIZE', the response includes statistics about item collections, if any,+-- that were modified during the operation are returned in the response. If+-- set to 'NONE' (the default), no statistics are returned.+diReturnItemCollectionMetrics :: Lens' DeleteItem (Maybe ReturnItemCollectionMetrics)+diReturnItemCollectionMetrics = lens _diReturnItemCollectionMetrics (\ s a -> s{_diReturnItemCollectionMetrics = a});++-- | A condition that must be satisfied in order for a conditional+-- /DeleteItem/ to succeed. ----- 'EQ' : Equal. 'EQ' is supported for all datatypes, including lists and maps.+-- An expression can contain any of the following: ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, Binary, String Set, Number Set, or Binary Set. If an item--- contains an /AttributeValue/ element of a different type than the one provided--- in the request, the value does not match. For example, '{"S":"6"}' does not--- equal '{"N":"6"}'. Also, '{"N":"6"}' does not equal '{"NS":["6", "2", "1"]}'.+-- -   Functions:+--     'attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size' --+--     These function names are case-sensitive. --+-- -   Comparison operators: ' = | \<> | \< | > | \<= | >= | BETWEEN | IN' ----- 'NE' : Not equal. 'NE' is supported for all datatypes, including lists and--- maps.+-- -   Logical operators: 'AND | OR | NOT' ----- /AttributeValueList/ can contain only one /AttributeValue/ of type String,--- Number, Binary, String Set, Number Set, or Binary Set. If an item contains an /AttributeValue/ of a different type than the one provided in the request, the--- value does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not equal '{"NS":["6", "2", "1"]}'.+-- For more information on condition expressions, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>+-- in the /Amazon DynamoDB Developer Guide/. --+-- /ConditionExpression/ replaces the legacy /ConditionalOperator/ and+-- /Expected/ parameters.+diConditionExpression :: Lens' DeleteItem (Maybe Text)+diConditionExpression = lens _diConditionExpression (\ s a -> s{_diConditionExpression = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /ConditionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception. --+-- A logical operator to apply to the conditions in the /Expected/ map: ----- 'LE' : Less than or equal.+-- -   'AND' - If all of the conditions evaluate to true, then the entire+--     map evaluates to true. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- -   'OR' - If at least one of the conditions evaluate to true, then the+--     entire map evaluates to true. --+-- If you omit /ConditionalOperator/, then 'AND' is the default. --+-- The operation will succeed only if the entire map evaluates to true. ----- 'LT' : Less than.+-- This parameter does not support attributes of type List or Map.+diConditionalOperator :: Lens' DeleteItem (Maybe ConditionalOperator)+diConditionalOperator = lens _diConditionalOperator (\ s a -> s{_diConditionalOperator = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /ConditionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception. ----- /AttributeValueList/ can contain only one /AttributeValue/ of type String,--- Number, or Binary (not a set type). If an item contains an /AttributeValue/--- element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- A map of attribute\/condition pairs. /Expected/ provides a conditional+-- block for the /DeleteItem/ operation. --+-- Each element of /Expected/ consists of an attribute name, a comparison+-- operator, and one or more values. DynamoDB compares the attribute with+-- the value(s) you supplied, using the comparison operator. For each+-- /Expected/ element, the result of the evaluation is either true or+-- false. --+-- If you specify more than one element in the /Expected/ map, then by+-- default all of the conditions must evaluate to true. In other words, the+-- conditions are ANDed together. (You can use the /ConditionalOperator/+-- parameter to OR the conditions instead. If you do this, then at least+-- one of the conditions must evaluate to true, rather than all of them.) ----- 'GE' : Greater than or equal.+-- If the /Expected/ map evaluates to true, then the conditional operation+-- succeeds; otherwise, it fails. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- /Expected/ contains the following: --+-- -   /AttributeValueList/ - One or more values to evaluate against the+--     supplied attribute. The number of values in the list depends on the+--     /ComparisonOperator/ being used. --+--     For type Number, value comparisons are numeric. ----- 'GT' : Greater than.+--     String value comparisons for greater than, equals, or less than are+--     based on ASCII character code values. For example, 'a' is greater+--     than 'A', and 'a' is greater than 'B'. For a list of code values,+--     see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+--     For type Binary, DynamoDB treats each byte of the binary data as+--     unsigned when it compares binary values. --+-- -   /ComparisonOperator/ - A comparator for evaluating attributes in the+--     /AttributeValueList/. When performing the comparison, DynamoDB uses+--     strongly consistent reads. --+--     The following comparison operators are available: ----- 'NOT_NULL' : The attribute exists. 'NOT_NULL' is supported for all datatypes,--- including lists and maps.+--     'EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN' ----- This operator tests for the existence of an attribute, not its data type. If--- the data type of attribute "'a'" is null, and you evaluate it using 'NOT_NULL',--- the result is a Boolean /true/. This result is because the attribute "'a'"--- exists; its data type is not relevant to the 'NOT_NULL' comparison operator.+--     The following are descriptions of each comparison operator. ----- 'NULL' : The attribute does not exist. 'NULL' is supported for all datatypes,--- including lists and maps.+--     -   'EQ' : Equal. 'EQ' is supported for all datatypes, including+--         lists and maps. ----- This operator tests for the nonexistence of an attribute, not its data type.--- If the data type of attribute "'a'" is null, and you evaluate it using 'NULL',--- the result is a Boolean /false/. This is because the attribute "'a'" exists; its--- data type is not relevant to the 'NULL' comparison operator.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, Binary, String Set, Number Set,+--         or Binary Set. If an item contains an /AttributeValue/ element+--         of a different type than the one provided in the request, the+--         value does not match. For example, '{\"S\":\"6\"}' does not+--         equal '{\"N\":\"6\"}'. Also, '{\"N\":\"6\"}' does not equal+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- 'CONTAINS' : Checks for a subsequence, or value in a set.+--     -   'NE' : Not equal. 'NE' is supported for all datatypes, including+--         lists and maps. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If the target attribute of the--- comparison is of type String, then the operator checks for a substring match.--- If the target attribute of the comparison is of type Binary, then the--- operator looks for a subsequence of the target that matches the input. If the--- target attribute of the comparison is a set ("'SS'", "'NS'", or "'BS'"), then the--- operator evaluates to true if it finds an exact match with any member of the--- set.+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String, Number, Binary, String Set, Number Set, or Binary+--         Set. If an item contains an /AttributeValue/ of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not equal+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- CONTAINS is supported for lists: When evaluating "'a CONTAINS b'", "'a'" can be--- a list; however, "'b'" cannot be a set, a map, or a list.+--     -   'LE' : Less than or equal. ----- 'NOT_CONTAINS' : Checks for absence of a subsequence, or absence of a value--- in a set.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If the target attribute of the--- comparison is a String, then the operator checks for the absence of a--- substring match. If the target attribute of the comparison is Binary, then--- the operator checks for the absence of a subsequence of the target that--- matches the input. If the target attribute of the comparison is a set ("'SS'", "'NS'", or "'BS'"), then the operator evaluates to true if it /does not/ find an--- exact match with any member of the set.+--     -   'LT' : Less than. ----- NOT_CONTAINS is supported for lists: When evaluating "'a NOT CONTAINS b'", "'a'"--- can be a list; however, "'b'" cannot be a set, a map, or a list.+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String, Number, or Binary (not a set type). If an item+--         contains an /AttributeValue/ element of a different type than+--         the one provided in the request, the value does not match. For+--         example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'. Also,+--         '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- 'BEGINS_WITH' : Checks for a prefix.+--     -   'GE' : Greater than or equal. ----- /AttributeValueList/ can contain only one /AttributeValue/ of type String or--- Binary (not a Number or a set type). The target attribute of the comparison--- must be of type String or Binary (not a Number or a set type).+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. --+--     -   'GT' : Greater than. --+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- 'IN' : Checks for matching elements within two sets.+--     -   'NOT_NULL' : The attribute exists. 'NOT_NULL' is supported for+--         all datatypes, including lists and maps. ----- /AttributeValueList/ can contain one or more /AttributeValue/ elements of type--- String, Number, or Binary (not a set type). These attributes are compared--- against an existing set type attribute of an item. If any elements of the--- input set are present in the item attribute, the expression evaluates to true.+--         This operator tests for the existence of an attribute, not its+--         data type. If the data type of attribute \"'a'\" is null, and+--         you evaluate it using 'NOT_NULL', the result is a Boolean+--         /true/. This result is because the attribute \"'a'\" exists; its+--         data type is not relevant to the 'NOT_NULL' comparison operator. ----- 'BETWEEN' : Greater than or equal to the first value, and less than or equal--- to the second value.+--     -   'NULL' : The attribute does not exist. 'NULL' is supported for+--         all datatypes, including lists and maps. ----- /AttributeValueList/ must contain two /AttributeValue/ elements of the same--- type, either String, Number, or Binary (not a set type). A target attribute--- matches if the target value is greater than, or equal to, the first element--- and less than, or equal to, the second element. If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not compare to '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'+--         This operator tests for the nonexistence of an attribute, not+--         its data type. If the data type of attribute \"'a'\" is null,+--         and you evaluate it using 'NULL', the result is a Boolean+--         /false/. This is because the attribute \"'a'\" exists; its data+--         type is not relevant to the 'NULL' comparison operator. ----- For usage examples of /AttributeValueList/ and /ComparisonOperator/, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html Legacy Conditional Parameters> in the /Amazon DynamoDB Developer Guide/.+--     -   'CONTAINS' : Checks for a subsequence, or value in a set. ----- For backward compatibility with previous DynamoDB releases, the following--- parameters can be used instead of /AttributeValueList/ and /ComparisonOperator/:+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         the target attribute of the comparison is of type String, then+--         the operator checks for a substring match. If the target+--         attribute of the comparison is of type Binary, then the operator+--         looks for a subsequence of the target that matches the input. If+--         the target attribute of the comparison is a set (\"'SS'\",+--         \"'NS'\", or \"'BS'\"), then the operator evaluates to true if+--         it finds an exact match with any member of the set. ----- /Value/ - A value for DynamoDB to compare with an attribute.+--         CONTAINS is supported for lists: When evaluating+--         \"'a CONTAINS b'\", \"'a'\" can be a list; however, \"'b'\"+--         cannot be a set, a map, or a list. ----- /Exists/ - A Boolean value that causes DynamoDB to evaluate the value before--- attempting the conditional operation:+--     -   'NOT_CONTAINS' : Checks for absence of a subsequence, or absence+--         of a value in a set. ----- If /Exists/ is 'true', DynamoDB will check to see if that attribute value--- already exists in the table. If it is found, then the condition evaluates to--- true; otherwise the condition evaluate to false.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         the target attribute of the comparison is a String, then the+--         operator checks for the absence of a substring match. If the+--         target attribute of the comparison is Binary, then the operator+--         checks for the absence of a subsequence of the target that+--         matches the input. If the target attribute of the comparison is+--         a set (\"'SS'\", \"'NS'\", or \"'BS'\"), then the operator+--         evaluates to true if it /does not/ find an exact match with any+--         member of the set. ----- If /Exists/ is 'false', DynamoDB assumes that the attribute value does /not/--- exist in the table. If in fact the value does not exist, then the assumption--- is valid and the condition evaluates to true. If the value is found, despite--- the assumption that it does not exist, the condition evaluates to false.+--         NOT_CONTAINS is supported for lists: When evaluating+--         \"'a NOT CONTAINS b'\", \"'a'\" can be a list; however, \"'b'\"+--         cannot be a set, a map, or a list. ----- Note that the default value for /Exists/ is 'true'.+--     -   'BEGINS_WITH' : Checks for a prefix. ----- The /Value/ and /Exists/ parameters are incompatible with /AttributeValueList/--- and /ComparisonOperator/. Note that if you use both sets of parameters at once,--- DynamoDB will return a /ValidationException/ exception.+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String or Binary (not a Number or a set type). The target+--         attribute of the comparison must be of type String or Binary+--         (not a Number or a set type). ----- This parameter does not support attributes of type List or Map.+--     -   'IN' : Checks for matching elements within two sets. ---diExpected :: Lens' DeleteItem (HashMap Text ExpectedAttributeValue)-diExpected = lens _diExpected (\s a -> s { _diExpected = a }) . _Map---- | One or more substitution tokens for attribute names in an expression. The--- following are some use cases for using /ExpressionAttributeNames/:+--         /AttributeValueList/ can contain one or more /AttributeValue/+--         elements of type String, Number, or Binary (not a set type).+--         These attributes are compared against an existing set type+--         attribute of an item. If any elements of the input set are+--         present in the item attribute, the expression evaluates to true. ----- To access an attribute whose name conflicts with a DynamoDB reserved word.+--     -   'BETWEEN' : Greater than or equal to the first value, and less+--         than or equal to the second value. ----- To create a placeholder for repeating occurrences of an attribute name in--- an expression.+--         /AttributeValueList/ must contain two /AttributeValue/ elements+--         of the same type, either String, Number, or Binary (not a set+--         type). A target attribute matches if the target value is greater+--         than, or equal to, the first element and less than, or equal to,+--         the second element. If an item contains an /AttributeValue/+--         element of a different type than the one provided in the+--         request, the value does not match. For example, '{\"S\":\"6\"}'+--         does not compare to '{\"N\":\"6\"}'. Also, '{\"N\":\"6\"}' does+--         not compare to '{\"NS\":[\"6\", \"2\", \"1\"]}' ----- To prevent special characters in an attribute name from being--- misinterpreted in an expression.+-- For usage examples of /AttributeValueList/ and /ComparisonOperator/, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html Legacy Conditional Parameters>+-- in the /Amazon DynamoDB Developer Guide/. ----- Use the # character in an expression to dereference an attribute name. For--- example, consider the following attribute name:+-- For backward compatibility with previous DynamoDB releases, the+-- following parameters can be used instead of /AttributeValueList/ and+-- /ComparisonOperator/: ----- 'Percentile'+-- -   /Value/ - A value for DynamoDB to compare with an attribute. ----- The name of this attribute conflicts with a reserved word, so it cannot be--- used directly in an expression. (For the complete list of reserved words, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words> in the /Amazon DynamoDB Developer Guide/). To work around this,--- you could specify the following for /ExpressionAttributeNames/:+-- -   /Exists/ - A Boolean value that causes DynamoDB to evaluate the+--     value before attempting the conditional operation: ----- '{"#P":"Percentile"}'+--     -   If /Exists/ is 'true', DynamoDB will check to see if that+--         attribute value already exists in the table. If it is found,+--         then the condition evaluates to true; otherwise the condition+--         evaluate to false. ----- You could then use this substitution in an expression, as in this example:+--     -   If /Exists/ is 'false', DynamoDB assumes that the attribute+--         value does /not/ exist in the table. If in fact the value does+--         not exist, then the assumption is valid and the condition+--         evaluates to true. If the value is found, despite the assumption+--         that it does not exist, the condition evaluates to false. ----- '#P = :val'+--     Note that the default value for /Exists/ is 'true'. ----- Tokens that begin with the : character are /expression attribute values/,--- which are placeholders for the actual value at runtime.+-- The /Value/ and /Exists/ parameters are incompatible with+-- /AttributeValueList/ and /ComparisonOperator/. Note that if you use both+-- sets of parameters at once, DynamoDB will return a /ValidationException/+-- exception. ----- For more information on expression attribute names, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.-diExpressionAttributeNames :: Lens' DeleteItem (HashMap Text Text)-diExpressionAttributeNames =-    lens _diExpressionAttributeNames-        (\s a -> s { _diExpressionAttributeNames = a })-            . _Map+-- This parameter does not support attributes of type List or Map.+diExpected :: Lens' DeleteItem (HashMap Text ExpectedAttributeValue)+diExpected = lens _diExpected (\ s a -> s{_diExpected = a}) . _Default . _Map; --- | One or more values that can be substituted in an expression.------ Use the : (colon) character in an expression to dereference an attribute--- value. For example, suppose that you wanted to check whether the value of the /ProductStatus/ attribute was one of the following:------ 'Available | Backordered | Discontinued'------ You would first need to specify /ExpressionAttributeValues/ as follows:------ '{ ":avail":{"S":"Available"}, ":back":{"S":"Backordered"},":disc":{"S":"Discontinued"} }'------ You could then use these values in an expression, such as this:------ 'ProductStatus IN (:avail, :back, :disc)'------ For more information on expression attribute values, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.-diExpressionAttributeValues :: Lens' DeleteItem (HashMap Text AttributeValue)-diExpressionAttributeValues =-    lens _diExpressionAttributeValues-        (\s a -> s { _diExpressionAttributeValues = a })-            . _Map+-- | The name of the table from which to delete the item.+diTableName :: Lens' DeleteItem Text+diTableName = lens _diTableName (\ s a -> s{_diTableName = a}); --- | A map of attribute names to /AttributeValue/ objects, representing the primary--- key of the item to delete.+-- | A map of attribute names to /AttributeValue/ objects, representing the+-- primary key of the item to delete. ----- For the primary key, you must provide all of the attributes. For example,--- with a hash type primary key, you only need to provide the hash attribute.--- For a hash-and-range type primary key, you must provide both the hash--- attribute and the range attribute.+-- For the primary key, you must provide all of the attributes. For+-- example, with a hash type primary key, you only need to provide the hash+-- attribute. For a hash-and-range type primary key, you must provide both+-- the hash attribute and the range attribute. diKey :: Lens' DeleteItem (HashMap Text AttributeValue)-diKey = lens _diKey (\s a -> s { _diKey = a }) . _Map+diKey = lens _diKey (\ s a -> s{_diKey = a}) . _Map; -diReturnConsumedCapacity :: Lens' DeleteItem (Maybe ReturnConsumedCapacity)-diReturnConsumedCapacity =-    lens _diReturnConsumedCapacity-        (\s a -> s { _diReturnConsumedCapacity = a })+instance AWSRequest DeleteItem where+        type Sv DeleteItem = DynamoDB+        type Rs DeleteItem = DeleteItemResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 DeleteItemResponse' <$>+                   (x .?> "ConsumedCapacity") <*>+                     (x .?> "ItemCollectionMetrics")+                     <*> (x .?> "Attributes" .!@ mempty)+                     <*> (pure (fromEnum s))) --- | A value that if set to 'SIZE', the response includes statistics about item--- collections, if any, that were modified during the operation are returned in--- the response. If set to 'NONE' (the default), no statistics are returned.-diReturnItemCollectionMetrics :: Lens' DeleteItem (Maybe ReturnItemCollectionMetrics)-diReturnItemCollectionMetrics =-    lens _diReturnItemCollectionMetrics-        (\s a -> s { _diReturnItemCollectionMetrics = a })+instance ToHeaders DeleteItem where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.DeleteItem" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) --- | Use /ReturnValues/ if you want to get the item attributes as they appeared--- before they were deleted. For /DeleteItem/, the valid values are:------ 'NONE' - If /ReturnValues/ is not specified, or if its value is 'NONE', then--- nothing is returned. (This setting is the default for /ReturnValues/.)------ 'ALL_OLD' - The content of the old item is returned.-------diReturnValues :: Lens' DeleteItem (Maybe ReturnValue)-diReturnValues = lens _diReturnValues (\s a -> s { _diReturnValues = a })+instance ToJSON DeleteItem where+        toJSON DeleteItem'{..}+          = object+              ["ReturnValues" .= _diReturnValues,+               "ExpressionAttributeNames" .=+                 _diExpressionAttributeNames,+               "ReturnConsumedCapacity" .=+                 _diReturnConsumedCapacity,+               "ExpressionAttributeValues" .=+                 _diExpressionAttributeValues,+               "ReturnItemCollectionMetrics" .=+                 _diReturnItemCollectionMetrics,+               "ConditionExpression" .= _diConditionExpression,+               "ConditionalOperator" .= _diConditionalOperator,+               "Expected" .= _diExpected,+               "TableName" .= _diTableName, "Key" .= _diKey] --- | The name of the table from which to delete the item.-diTableName :: Lens' DeleteItem Text-diTableName = lens _diTableName (\s a -> s { _diTableName = a })+instance ToPath DeleteItem where+        toPath = const "/" -data DeleteItemResponse = DeleteItemResponse-    { _dirAttributes            :: Map Text AttributeValue-    , _dirConsumedCapacity      :: Maybe ConsumedCapacity-    , _dirItemCollectionMetrics :: Maybe ItemCollectionMetrics-    } deriving (Eq, Read, Show)+instance ToQuery DeleteItem where+        toQuery = const mempty --- | 'DeleteItemResponse' constructor.+-- | Represents the output of a /DeleteItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'deleteItemResponse' smart constructor.+data DeleteItemResponse = DeleteItemResponse'+    { _dirsConsumedCapacity      :: !(Maybe ConsumedCapacity)+    , _dirsItemCollectionMetrics :: !(Maybe ItemCollectionMetrics)+    , _dirsAttributes            :: !(Maybe (Map Text AttributeValue))+    , _dirsStatus                :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'DeleteItemResponse' with the minimum fields required to make a request. ----- * 'dirAttributes' @::@ 'HashMap' 'Text' 'AttributeValue'+-- Use one of the following lenses to modify other fields as desired: ----- * 'dirConsumedCapacity' @::@ 'Maybe' 'ConsumedCapacity'+-- * 'dirsConsumedCapacity' ----- * 'dirItemCollectionMetrics' @::@ 'Maybe' 'ItemCollectionMetrics'+-- * 'dirsItemCollectionMetrics' ---deleteItemResponse :: DeleteItemResponse-deleteItemResponse = DeleteItemResponse-    { _dirAttributes            = mempty-    , _dirConsumedCapacity      = Nothing-    , _dirItemCollectionMetrics = Nothing+-- * 'dirsAttributes'+--+-- * 'dirsStatus'+deleteItemResponse+    :: Int -- ^ 'dirsStatus'+    -> DeleteItemResponse+deleteItemResponse pStatus_ =+    DeleteItemResponse'+    { _dirsConsumedCapacity = Nothing+    , _dirsItemCollectionMetrics = Nothing+    , _dirsAttributes = Nothing+    , _dirsStatus = pStatus_     } --- | A map of attribute names to /AttributeValue/ objects, representing the item as--- it appeared before the /DeleteItem/ operation. This map appears in the response--- only if /ReturnValues/ was specified as 'ALL_OLD' in the request.-dirAttributes :: Lens' DeleteItemResponse (HashMap Text AttributeValue)-dirAttributes = lens _dirAttributes (\s a -> s { _dirAttributes = a }) . _Map--dirConsumedCapacity :: Lens' DeleteItemResponse (Maybe ConsumedCapacity)-dirConsumedCapacity =-    lens _dirConsumedCapacity (\s a -> s { _dirConsumedCapacity = a })+-- | Undocumented member.+dirsConsumedCapacity :: Lens' DeleteItemResponse (Maybe ConsumedCapacity)+dirsConsumedCapacity = lens _dirsConsumedCapacity (\ s a -> s{_dirsConsumedCapacity = a});  -- | Information about item collections, if any, that were affected by the--- operation. /ItemCollectionMetrics/ is only returned if the request asked for--- it. If the table does not have any local secondary indexes, this information--- is not returned in the response.+-- operation. /ItemCollectionMetrics/ is only returned if the request asked+-- for it. If the table does not have any local secondary indexes, this+-- information is not returned in the response. -- -- Each /ItemCollectionMetrics/ element consists of: ----- /ItemCollectionKey/ - The hash key value of the item collection. This is the--- same as the hash key of the item.------ /SizeEstimateRange/ - An estimate of item collection size, in gigabytes. This--- value is a two-element array containing a lower bound and an upper bound for--- the estimate. The estimate includes the size of all the items in the table,--- plus the size of all attributes projected into all of the local secondary--- indexes on that table. Use this estimate to measure whether a local secondary--- index is approaching its size limit.+-- -   /ItemCollectionKey/ - The hash key value of the item collection.+--     This is the same as the hash key of the item. ----- The estimate is subject to change over time; therefore, do not rely on the--- precision or accuracy of the estimate.+-- -   /SizeEstimateRange/ - An estimate of item collection size, in+--     gigabytes. This value is a two-element array containing a lower+--     bound and an upper bound for the estimate. The estimate includes the+--     size of all the items in the table, plus the size of all attributes+--     projected into all of the local secondary indexes on that table. Use+--     this estimate to measure whether a local secondary index is+--     approaching its size limit. --+--     The estimate is subject to change over time; therefore, do not rely+--     on the precision or accuracy of the estimate. ---dirItemCollectionMetrics :: Lens' DeleteItemResponse (Maybe ItemCollectionMetrics)-dirItemCollectionMetrics =-    lens _dirItemCollectionMetrics-        (\s a -> s { _dirItemCollectionMetrics = a })--instance ToPath DeleteItem where-    toPath = const "/"--instance ToQuery DeleteItem where-    toQuery = const mempty--instance ToHeaders DeleteItem--instance ToJSON DeleteItem where-    toJSON DeleteItem{..} = object-        [ "TableName"                   .= _diTableName-        , "Key"                         .= _diKey-        , "Expected"                    .= _diExpected-        , "ConditionalOperator"         .= _diConditionalOperator-        , "ReturnValues"                .= _diReturnValues-        , "ReturnConsumedCapacity"      .= _diReturnConsumedCapacity-        , "ReturnItemCollectionMetrics" .= _diReturnItemCollectionMetrics-        , "ConditionExpression"         .= _diConditionExpression-        , "ExpressionAttributeNames"    .= _diExpressionAttributeNames-        , "ExpressionAttributeValues"   .= _diExpressionAttributeValues-        ]--instance AWSRequest DeleteItem where-    type Sv DeleteItem = DynamoDB-    type Rs DeleteItem = DeleteItemResponse+dirsItemCollectionMetrics :: Lens' DeleteItemResponse (Maybe ItemCollectionMetrics)+dirsItemCollectionMetrics = lens _dirsItemCollectionMetrics (\ s a -> s{_dirsItemCollectionMetrics = a}); -    request  = post "DeleteItem"-    response = jsonResponse+-- | A map of attribute names to /AttributeValue/ objects, representing the+-- item as it appeared before the /DeleteItem/ operation. This map appears+-- in the response only if /ReturnValues/ was specified as 'ALL_OLD' in the+-- request.+dirsAttributes :: Lens' DeleteItemResponse (HashMap Text AttributeValue)+dirsAttributes = lens _dirsAttributes (\ s a -> s{_dirsAttributes = a}) . _Default . _Map; -instance FromJSON DeleteItemResponse where-    parseJSON = withObject "DeleteItemResponse" $ \o -> DeleteItemResponse-        <$> o .:? "Attributes" .!= mempty-        <*> o .:? "ConsumedCapacity"-        <*> o .:? "ItemCollectionMetrics"+-- | The response status code.+dirsStatus :: Lens' DeleteItemResponse Int+dirsStatus = lens _dirsStatus (\ s a -> s{_dirsStatus = a});

@@ -1,121 +1,148 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.DeleteTable--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | The /DeleteTable/ operation deletes a table and all of its items. After a /DeleteTable/ request, the specified table is in the 'DELETING' state until DynamoDB--- completes the deletion. If the table is in the 'ACTIVE' state, you can delete--- it. If a table is in 'CREATING' or 'UPDATING' states, then DynamoDB returns a /ResourceInUseException/. If the specified table does not exist, DynamoDB returns a /ResourceNotFoundException/. If table is already in the 'DELETING' state, no error is returned.+-- The /DeleteTable/ operation deletes a table and all of its items. After+-- a /DeleteTable/ request, the specified table is in the 'DELETING' state+-- until DynamoDB completes the deletion. If the table is in the 'ACTIVE'+-- state, you can delete it. If a table is in 'CREATING' or 'UPDATING'+-- states, then DynamoDB returns a /ResourceInUseException/. If the+-- specified table does not exist, DynamoDB returns a+-- /ResourceNotFoundException/. If table is already in the 'DELETING'+-- state, no error is returned. ----- DynamoDB might continue to accept data read and write operations, such as /GetItem/ and /PutItem/, on a table in the 'DELETING' state until the table deletion is--- complete.+-- DynamoDB might continue to accept data read and write operations, such+-- as /GetItem/ and /PutItem/, on a table in the 'DELETING' state until the+-- table deletion is complete. -- -- When you delete a table, any indexes on that table are also deleted. --+-- If you have DynamoDB Streams enabled on the table, then the+-- corresponding stream on that table goes into the 'DISABLED' state, and+-- the stream is automatically deleted after 24 hours.+-- -- Use the /DescribeTable/ API to check the status of the table. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html AWS API Reference> for DeleteTable. module Network.AWS.DynamoDB.DeleteTable     (-    -- * Request-      DeleteTable-    -- ** Request constructor-    , deleteTable-    -- ** Request lenses+    -- * Creating a Request+      deleteTable+    , DeleteTable+    -- * Request Lenses     , dtTableName -    -- * Response-    , DeleteTableResponse-    -- ** Response constructor+    -- * Destructuring the Response     , deleteTableResponse-    -- ** Response lenses-    , dtrTableDescription+    , DeleteTableResponse+    -- * Response Lenses+    , dtrsTableDescription+    , dtrsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response -newtype DeleteTable = DeleteTable+-- | Represents the input of a /DeleteTable/ operation.+--+-- /See:/ 'deleteTable' smart constructor.+newtype DeleteTable = DeleteTable'     { _dtTableName :: Text-    } deriving (Eq, Ord, Read, Show, Monoid, IsString)+    } deriving (Eq,Read,Show,Data,Typeable,Generic) --- | 'DeleteTable' constructor.------ The fields accessible through corresponding lenses are:+-- | Creates a value of 'DeleteTable' with the minimum fields required to make a request. ----- * 'dtTableName' @::@ 'Text'+-- Use one of the following lenses to modify other fields as desired: ---deleteTable :: Text -- ^ 'dtTableName'-            -> DeleteTable-deleteTable p1 = DeleteTable-    { _dtTableName = p1+-- * 'dtTableName'+deleteTable+    :: Text -- ^ 'dtTableName'+    -> DeleteTable+deleteTable pTableName_ =+    DeleteTable'+    { _dtTableName = pTableName_     }  -- | The name of the table to delete. dtTableName :: Lens' DeleteTable Text-dtTableName = lens _dtTableName (\s a -> s { _dtTableName = a })+dtTableName = lens _dtTableName (\ s a -> s{_dtTableName = a}); -newtype DeleteTableResponse = DeleteTableResponse-    { _dtrTableDescription :: Maybe TableDescription-    } deriving (Eq, Read, Show)+instance AWSRequest DeleteTable where+        type Sv DeleteTable = DynamoDB+        type Rs DeleteTable = DeleteTableResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 DeleteTableResponse' <$>+                   (x .?> "TableDescription") <*> (pure (fromEnum s))) --- | 'DeleteTableResponse' constructor.------ The fields accessible through corresponding lenses are:------ * 'dtrTableDescription' @::@ 'Maybe' 'TableDescription'----deleteTableResponse :: DeleteTableResponse-deleteTableResponse = DeleteTableResponse-    { _dtrTableDescription = Nothing-    }+instance ToHeaders DeleteTable where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.DeleteTable" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) -dtrTableDescription :: Lens' DeleteTableResponse (Maybe TableDescription)-dtrTableDescription =-    lens _dtrTableDescription (\s a -> s { _dtrTableDescription = a })+instance ToJSON DeleteTable where+        toJSON DeleteTable'{..}+          = object ["TableName" .= _dtTableName]  instance ToPath DeleteTable where-    toPath = const "/"+        toPath = const "/"  instance ToQuery DeleteTable where-    toQuery = const mempty--instance ToHeaders DeleteTable+        toQuery = const mempty -instance ToJSON DeleteTable where-    toJSON DeleteTable{..} = object-        [ "TableName" .= _dtTableName-        ]+-- | Represents the output of a /DeleteTable/ operation.+--+-- /See:/ 'deleteTableResponse' smart constructor.+data DeleteTableResponse = DeleteTableResponse'+    { _dtrsTableDescription :: !(Maybe TableDescription)+    , _dtrsStatus           :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic) -instance AWSRequest DeleteTable where-    type Sv DeleteTable = DynamoDB-    type Rs DeleteTable = DeleteTableResponse+-- | Creates a value of 'DeleteTableResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'dtrsTableDescription'+--+-- * 'dtrsStatus'+deleteTableResponse+    :: Int -- ^ 'dtrsStatus'+    -> DeleteTableResponse+deleteTableResponse pStatus_ =+    DeleteTableResponse'+    { _dtrsTableDescription = Nothing+    , _dtrsStatus = pStatus_+    } -    request  = post "DeleteTable"-    response = jsonResponse+-- | Undocumented member.+dtrsTableDescription :: Lens' DeleteTableResponse (Maybe TableDescription)+dtrsTableDescription = lens _dtrsTableDescription (\ s a -> s{_dtrsTableDescription = a}); -instance FromJSON DeleteTableResponse where-    parseJSON = withObject "DeleteTableResponse" $ \o -> DeleteTableResponse-        <$> o .:? "TableDescription"+-- | The response status code.+dtrsStatus :: Lens' DeleteTableResponse Int+dtrsStatus = lens _dtrsStatus (\ s a -> s{_dtrsStatus = a});

@@ -1,122 +1,137 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.DescribeTable--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | Returns information about the table, including the current status of the--- table, when it was created, the primary key schema, and any indexes on the--- table.+-- Returns information about the table, including the current status of the+-- table, when it was created, the primary key schema, and any indexes on+-- the table. -- -- If you issue a DescribeTable request immediately after a CreateTable--- request, DynamoDB might return a ResourceNotFoundException. This is because--- DescribeTable uses an eventually consistent query, and the metadata for your--- table might not be available at that moment. Wait for a few seconds, and then--- try the DescribeTable request again.------+-- request, DynamoDB might return a ResourceNotFoundException. This is+-- because DescribeTable uses an eventually consistent query, and the+-- metadata for your table might not be available at that moment. Wait for+-- a few seconds, and then try the DescribeTable request again. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html AWS API Reference> for DescribeTable. module Network.AWS.DynamoDB.DescribeTable     (-    -- * Request-      DescribeTable-    -- ** Request constructor-    , describeTable-    -- ** Request lenses-    , dt1TableName+    -- * Creating a Request+      describeTable+    , DescribeTable+    -- * Request Lenses+    , dTableName -    -- * Response-    , DescribeTableResponse-    -- ** Response constructor+    -- * Destructuring the Response     , describeTableResponse-    -- ** Response lenses-    , dtrTable+    , DescribeTableResponse+    -- * Response Lenses+    , drsTable+    , drsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--newtype DescribeTable = DescribeTable-    { _dt1TableName :: Text-    } deriving (Eq, Ord, Read, Show, Monoid, IsString)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'DescribeTable' constructor.+-- | Represents the input of a /DescribeTable/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'describeTable' smart constructor.+newtype DescribeTable = DescribeTable'+    { _dTableName :: Text+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'DescribeTable' with the minimum fields required to make a request. ----- * 'dt1TableName' @::@ 'Text'+-- Use one of the following lenses to modify other fields as desired: ---describeTable :: Text -- ^ 'dt1TableName'-              -> DescribeTable-describeTable p1 = DescribeTable-    { _dt1TableName = p1+-- * 'dTableName'+describeTable+    :: Text -- ^ 'dTableName'+    -> DescribeTable+describeTable pTableName_ =+    DescribeTable'+    { _dTableName = pTableName_     }  -- | The name of the table to describe.-dt1TableName :: Lens' DescribeTable Text-dt1TableName = lens _dt1TableName (\s a -> s { _dt1TableName = a })+dTableName :: Lens' DescribeTable Text+dTableName = lens _dTableName (\ s a -> s{_dTableName = a}); -newtype DescribeTableResponse = DescribeTableResponse-    { _dtrTable :: TableDescription-    } deriving (Eq, Read, Show)+instance AWSRequest DescribeTable where+        type Sv DescribeTable = DynamoDB+        type Rs DescribeTable = DescribeTableResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 DescribeTableResponse' <$>+                   (x .?> "Table") <*> (pure (fromEnum s))) --- | 'DescribeTableResponse' constructor.------ The fields accessible through corresponding lenses are:------ * 'dtrTable' @::@ 'TableDescription'----describeTableResponse :: TableDescription -- ^ 'dtrTable'-                      -> DescribeTableResponse-describeTableResponse p1 = DescribeTableResponse-    { _dtrTable = p1-    }+instance ToHeaders DescribeTable where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.DescribeTable" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) -dtrTable :: Lens' DescribeTableResponse TableDescription-dtrTable = lens _dtrTable (\s a -> s { _dtrTable = a })+instance ToJSON DescribeTable where+        toJSON DescribeTable'{..}+          = object ["TableName" .= _dTableName]  instance ToPath DescribeTable where-    toPath = const "/"+        toPath = const "/"  instance ToQuery DescribeTable where-    toQuery = const mempty--instance ToHeaders DescribeTable+        toQuery = const mempty -instance ToJSON DescribeTable where-    toJSON DescribeTable{..} = object-        [ "TableName" .= _dt1TableName-        ]+-- | Represents the output of a /DescribeTable/ operation.+--+-- /See:/ 'describeTableResponse' smart constructor.+data DescribeTableResponse = DescribeTableResponse'+    { _drsTable  :: !(Maybe TableDescription)+    , _drsStatus :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic) -instance AWSRequest DescribeTable where-    type Sv DescribeTable = DynamoDB-    type Rs DescribeTable = DescribeTableResponse+-- | Creates a value of 'DescribeTableResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'drsTable'+--+-- * 'drsStatus'+describeTableResponse+    :: Int -- ^ 'drsStatus'+    -> DescribeTableResponse+describeTableResponse pStatus_ =+    DescribeTableResponse'+    { _drsTable = Nothing+    , _drsStatus = pStatus_+    } -    request  = post "DescribeTable"-    response = jsonResponse+-- | Undocumented member.+drsTable :: Lens' DescribeTableResponse (Maybe TableDescription)+drsTable = lens _drsTable (\ s a -> s{_drsTable = a}); -instance FromJSON DescribeTableResponse where-    parseJSON = withObject "DescribeTableResponse" $ \o -> DescribeTableResponse-        <$> o .:  "Table"+-- | The response status code.+drsStatus :: Lens' DescribeTableResponse Int+drsStatus = lens _drsStatus (\ s a -> s{_drsStatus = a});

@@ -1,256 +1,280 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.GetItem--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | The /GetItem/ operation returns a set of attributes for the item with the given--- primary key. If there is no matching item, /GetItem/ does not return any data.+-- The /GetItem/ operation returns a set of attributes for the item with+-- the given primary key. If there is no matching item, /GetItem/ does not+-- return any data. -- -- /GetItem/ provides an eventually consistent read by default. If your--- application requires a strongly consistent read, set /ConsistentRead/ to 'true'.--- Although a strongly consistent read might take more time than an eventually--- consistent read, it always returns the last updated value.+-- application requires a strongly consistent read, set /ConsistentRead/ to+-- 'true'. Although a strongly consistent read might take more time than an+-- eventually consistent read, it always returns the last updated value. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_GetItem.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_GetItem.html AWS API Reference> for GetItem. module Network.AWS.DynamoDB.GetItem     (-    -- * Request-      GetItem-    -- ** Request constructor-    , getItem-    -- ** Request lenses-    , giAttributesToGet+    -- * Creating a Request+      getItem+    , GetItem+    -- * Request Lenses+    , giProjectionExpression     , giConsistentRead     , giExpressionAttributeNames-    , giKey-    , giProjectionExpression+    , giAttributesToGet     , giReturnConsumedCapacity     , giTableName+    , giKey -    -- * Response-    , GetItemResponse-    -- ** Response constructor+    -- * Destructuring the Response     , getItemResponse-    -- ** Response lenses-    , girConsumedCapacity-    , girItem+    , GetItemResponse+    -- * Response Lenses+    , girsConsumedCapacity+    , girsItem+    , girsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data GetItem = GetItem-    { _giAttributesToGet          :: List1 "AttributesToGet" Text-    , _giConsistentRead           :: Maybe Bool-    , _giExpressionAttributeNames :: Map Text Text-    , _giKey                      :: Map Text AttributeValue-    , _giProjectionExpression     :: Maybe Text-    , _giReturnConsumedCapacity   :: Maybe ReturnConsumedCapacity-    , _giTableName                :: Text-    } deriving (Eq, Read, Show)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'GetItem' constructor.+-- | Represents the input of a /GetItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'getItem' smart constructor.+data GetItem = GetItem'+    { _giProjectionExpression     :: !(Maybe Text)+    , _giConsistentRead           :: !(Maybe Bool)+    , _giExpressionAttributeNames :: !(Maybe (Map Text Text))+    , _giAttributesToGet          :: !(Maybe (List1 Text))+    , _giReturnConsumedCapacity   :: !(Maybe ReturnConsumedCapacity)+    , _giTableName                :: !Text+    , _giKey                      :: !(Map Text AttributeValue)+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'GetItem' with the minimum fields required to make a request. ----- * 'giAttributesToGet' @::@ 'NonEmpty' 'Text'+-- Use one of the following lenses to modify other fields as desired: ----- * 'giConsistentRead' @::@ 'Maybe' 'Bool'+-- * 'giProjectionExpression' ----- * 'giExpressionAttributeNames' @::@ 'HashMap' 'Text' 'Text'+-- * 'giConsistentRead' ----- * 'giKey' @::@ 'HashMap' 'Text' 'AttributeValue'+-- * 'giExpressionAttributeNames' ----- * 'giProjectionExpression' @::@ 'Maybe' 'Text'+-- * 'giAttributesToGet' ----- * 'giReturnConsumedCapacity' @::@ 'Maybe' 'ReturnConsumedCapacity'+-- * 'giReturnConsumedCapacity' ----- * 'giTableName' @::@ 'Text'+-- * 'giTableName' ---getItem :: Text -- ^ 'giTableName'-        -> NonEmpty Text -- ^ 'giAttributesToGet'-        -> GetItem-getItem p1 p2 = GetItem-    { _giTableName                = p1-    , _giAttributesToGet          = withIso _List1 (const id) p2-    , _giKey                      = mempty-    , _giConsistentRead           = Nothing-    , _giReturnConsumedCapacity   = Nothing-    , _giProjectionExpression     = Nothing-    , _giExpressionAttributeNames = mempty+-- * 'giKey'+getItem+    :: Text -- ^ 'giTableName'+    -> GetItem+getItem pTableName_ =+    GetItem'+    { _giProjectionExpression = Nothing+    , _giConsistentRead = Nothing+    , _giExpressionAttributeNames = Nothing+    , _giAttributesToGet = Nothing+    , _giReturnConsumedCapacity = Nothing+    , _giTableName = pTableName_+    , _giKey = mempty     } --- | This is a legacy parameter, for backward compatibility. New applications--- should use /ProjectionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.+-- | A string that identifies one or more attributes to retrieve from the+-- table. These attributes can include scalars, sets, or elements of a JSON+-- document. The attributes in the expression must be separated by commas. ----- This parameter allows you to retrieve attributes of type List or Map;--- however, it cannot retrieve individual elements within a List or a Map.+-- If no attribute names are specified, then all attributes will be+-- returned. If any of the requested attributes are not found, they will+-- not appear in the result. ----- The names of one or more attributes to retrieve. If no attribute names are--- provided, then all attributes will be returned. If any of the requested--- attributes are not found, they will not appear in the result.+-- For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+-- in the /Amazon DynamoDB Developer Guide/. ----- Note that /AttributesToGet/ has no effect on provisioned throughput--- consumption. DynamoDB determines capacity units consumed based on item size,--- not on the amount of data that is returned to an application.-giAttributesToGet :: Lens' GetItem (NonEmpty Text)-giAttributesToGet =-    lens _giAttributesToGet (\s a -> s { _giAttributesToGet = a })-        . _List1+-- /ProjectionExpression/ replaces the legacy /AttributesToGet/ parameter.+giProjectionExpression :: Lens' GetItem (Maybe Text)+giProjectionExpression = lens _giProjectionExpression (\ s a -> s{_giProjectionExpression = a}); --- | A value that if set to 'true', then the operation uses strongly consistent--- reads; otherwise, eventually consistent reads are used.+-- | Determines the read consistency model: If set to 'true', then the+-- operation uses strongly consistent reads; otherwise, the operation uses+-- eventually consistent reads. giConsistentRead :: Lens' GetItem (Maybe Bool)-giConsistentRead = lens _giConsistentRead (\s a -> s { _giConsistentRead = a })+giConsistentRead = lens _giConsistentRead (\ s a -> s{_giConsistentRead = a}); --- | One or more substitution tokens for attribute names in an expression. The--- following are some use cases for using /ExpressionAttributeNames/:+-- | One or more substitution tokens for attribute names in an expression.+-- The following are some use cases for using /ExpressionAttributeNames/: ----- To access an attribute whose name conflicts with a DynamoDB reserved word.+-- -   To access an attribute whose name conflicts with a DynamoDB reserved+--     word. ----- To create a placeholder for repeating occurrences of an attribute name in--- an expression.+-- -   To create a placeholder for repeating occurrences of an attribute+--     name in an expression. ----- To prevent special characters in an attribute name from being--- misinterpreted in an expression.+-- -   To prevent special characters in an attribute name from being+--     misinterpreted in an expression. ----- Use the # character in an expression to dereference an attribute name. For--- example, consider the following attribute name:+-- Use the __#__ character in an expression to dereference an attribute+-- name. For example, consider the following attribute name: ----- 'Percentile'+-- -   'Percentile' ----- The name of this attribute conflicts with a reserved word, so it cannot be--- used directly in an expression. (For the complete list of reserved words, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words> in the /Amazon DynamoDB Developer Guide/). To work around this,--- you could specify the following for /ExpressionAttributeNames/:+-- The name of this attribute conflicts with a reserved word, so it cannot+-- be used directly in an expression. (For the complete list of reserved+-- words, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words>+-- in the /Amazon DynamoDB Developer Guide/). To work around this, you+-- could specify the following for /ExpressionAttributeNames/: ----- '{"#P":"Percentile"}'+-- -   '{\"#P\":\"Percentile\"}' ----- You could then use this substitution in an expression, as in this example:+-- You could then use this substitution in an expression, as in this+-- example: ----- '#P = :val'+-- -   '#P = :val' ----- Tokens that begin with the : character are /expression attribute values/,--- which are placeholders for the actual value at runtime.+-- Tokens that begin with the __:__ character are /expression attribute+-- values/, which are placeholders for the actual value at runtime. ----- For more information on expression attribute names, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.+-- For more information on expression attribute names, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+-- in the /Amazon DynamoDB Developer Guide/. giExpressionAttributeNames :: Lens' GetItem (HashMap Text Text)-giExpressionAttributeNames =-    lens _giExpressionAttributeNames-        (\s a -> s { _giExpressionAttributeNames = a })-            . _Map---- | A map of attribute names to /AttributeValue/ objects, representing the primary--- key of the item to retrieve.------ For the primary key, you must provide all of the attributes. For example,--- with a hash type primary key, you only need to provide the hash attribute.--- For a hash-and-range type primary key, you must provide both the hash--- attribute and the range attribute.-giKey :: Lens' GetItem (HashMap Text AttributeValue)-giKey = lens _giKey (\s a -> s { _giKey = a }) . _Map+giExpressionAttributeNames = lens _giExpressionAttributeNames (\ s a -> s{_giExpressionAttributeNames = a}) . _Default . _Map; --- | A string that identifies one or more attributes to retrieve from the table.--- These attributes can include scalars, sets, or elements of a JSON document.--- The attributes in the expression must be separated by commas.------ If no attribute names are specified, then all attributes will be returned.--- If any of the requested attributes are not found, they will not appear in the--- result.+-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /ProjectionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception. ----- For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes> in the /Amazon DynamoDBDeveloper Guide/.+-- This parameter allows you to retrieve attributes of type List or Map;+-- however, it cannot retrieve individual elements within a List or a Map. ----- /ProjectionExpression/ replaces the legacy /AttributesToGet/ parameter.+-- The names of one or more attributes to retrieve. If no attribute names+-- are provided, then all attributes will be returned. If any of the+-- requested attributes are not found, they will not appear in the result. ---giProjectionExpression :: Lens' GetItem (Maybe Text)-giProjectionExpression =-    lens _giProjectionExpression (\s a -> s { _giProjectionExpression = a })+-- Note that /AttributesToGet/ has no effect on provisioned throughput+-- consumption. DynamoDB determines capacity units consumed based on item+-- size, not on the amount of data that is returned to an application.+giAttributesToGet :: Lens' GetItem (Maybe (NonEmpty Text))+giAttributesToGet = lens _giAttributesToGet (\ s a -> s{_giAttributesToGet = a}) . mapping _List1; +-- | Undocumented member. giReturnConsumedCapacity :: Lens' GetItem (Maybe ReturnConsumedCapacity)-giReturnConsumedCapacity =-    lens _giReturnConsumedCapacity-        (\s a -> s { _giReturnConsumedCapacity = a })+giReturnConsumedCapacity = lens _giReturnConsumedCapacity (\ s a -> s{_giReturnConsumedCapacity = a});  -- | The name of the table containing the requested item. giTableName :: Lens' GetItem Text-giTableName = lens _giTableName (\s a -> s { _giTableName = a })--data GetItemResponse = GetItemResponse-    { _girConsumedCapacity :: Maybe ConsumedCapacity-    , _girItem             :: Map Text AttributeValue-    } deriving (Eq, Read, Show)+giTableName = lens _giTableName (\ s a -> s{_giTableName = a}); --- | 'GetItemResponse' constructor.------ The fields accessible through corresponding lenses are:------ * 'girConsumedCapacity' @::@ 'Maybe' 'ConsumedCapacity'------ * 'girItem' @::@ 'HashMap' 'Text' 'AttributeValue'+-- | A map of attribute names to /AttributeValue/ objects, representing the+-- primary key of the item to retrieve. ---getItemResponse :: GetItemResponse-getItemResponse = GetItemResponse-    { _girItem             = mempty-    , _girConsumedCapacity = Nothing-    }+-- For the primary key, you must provide all of the attributes. For+-- example, with a hash type primary key, you only need to provide the hash+-- attribute. For a hash-and-range type primary key, you must provide both+-- the hash attribute and the range attribute.+giKey :: Lens' GetItem (HashMap Text AttributeValue)+giKey = lens _giKey (\ s a -> s{_giKey = a}) . _Map; -girConsumedCapacity :: Lens' GetItemResponse (Maybe ConsumedCapacity)-girConsumedCapacity =-    lens _girConsumedCapacity (\s a -> s { _girConsumedCapacity = a })+instance AWSRequest GetItem where+        type Sv GetItem = DynamoDB+        type Rs GetItem = GetItemResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 GetItemResponse' <$>+                   (x .?> "ConsumedCapacity") <*>+                     (x .?> "Item" .!@ mempty)+                     <*> (pure (fromEnum s))) --- | A map of attribute names to /AttributeValue/ objects, as specified by /AttributesToGet/.-girItem :: Lens' GetItemResponse (HashMap Text AttributeValue)-girItem = lens _girItem (\s a -> s { _girItem = a }) . _Map+instance ToHeaders GetItem where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.GetItem" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) +instance ToJSON GetItem where+        toJSON GetItem'{..}+          = object+              ["ProjectionExpression" .= _giProjectionExpression,+               "ConsistentRead" .= _giConsistentRead,+               "ExpressionAttributeNames" .=+                 _giExpressionAttributeNames,+               "AttributesToGet" .= _giAttributesToGet,+               "ReturnConsumedCapacity" .=+                 _giReturnConsumedCapacity,+               "TableName" .= _giTableName, "Key" .= _giKey]+ instance ToPath GetItem where-    toPath = const "/"+        toPath = const "/"  instance ToQuery GetItem where-    toQuery = const mempty+        toQuery = const mempty -instance ToHeaders GetItem+-- | Represents the output of a /GetItem/ operation.+--+-- /See:/ 'getItemResponse' smart constructor.+data GetItemResponse = GetItemResponse'+    { _girsConsumedCapacity :: !(Maybe ConsumedCapacity)+    , _girsItem             :: !(Maybe (Map Text AttributeValue))+    , _girsStatus           :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic) -instance ToJSON GetItem where-    toJSON GetItem{..} = object-        [ "TableName"                .= _giTableName-        , "Key"                      .= _giKey-        , "AttributesToGet"          .= _giAttributesToGet-        , "ConsistentRead"           .= _giConsistentRead-        , "ReturnConsumedCapacity"   .= _giReturnConsumedCapacity-        , "ProjectionExpression"     .= _giProjectionExpression-        , "ExpressionAttributeNames" .= _giExpressionAttributeNames-        ]+-- | Creates a value of 'GetItemResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'girsConsumedCapacity'+--+-- * 'girsItem'+--+-- * 'girsStatus'+getItemResponse+    :: Int -- ^ 'girsStatus'+    -> GetItemResponse+getItemResponse pStatus_ =+    GetItemResponse'+    { _girsConsumedCapacity = Nothing+    , _girsItem = Nothing+    , _girsStatus = pStatus_+    } -instance AWSRequest GetItem where-    type Sv GetItem = DynamoDB-    type Rs GetItem = GetItemResponse+-- | Undocumented member.+girsConsumedCapacity :: Lens' GetItemResponse (Maybe ConsumedCapacity)+girsConsumedCapacity = lens _girsConsumedCapacity (\ s a -> s{_girsConsumedCapacity = a}); -    request  = post "GetItem"-    response = jsonResponse+-- | A map of attribute names to /AttributeValue/ objects, as specified by+-- /AttributesToGet/.+girsItem :: Lens' GetItemResponse (HashMap Text AttributeValue)+girsItem = lens _girsItem (\ s a -> s{_girsItem = a}) . _Default . _Map; -instance FromJSON GetItemResponse where-    parseJSON = withObject "GetItemResponse" $ \o -> GetItemResponse-        <$> o .:? "ConsumedCapacity"-        <*> o .:? "Item" .!= mempty+-- | The response status code.+girsStatus :: Lens' GetItemResponse Int+girsStatus = lens _girsStatus (\ s a -> s{_girsStatus = a});

@@ -1,156 +1,178 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.ListTables--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | Returns an array of table names associated with the current account and--- endpoint. The output from /ListTables/ is paginated, with each page returning a--- maximum of 100 table names.+-- Returns an array of table names associated with the current account and+-- endpoint. The output from /ListTables/ is paginated, with each page+-- returning a maximum of 100 table names. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTables.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTables.html AWS API Reference> for ListTables.+--+-- This operation returns paginated results. module Network.AWS.DynamoDB.ListTables     (-    -- * Request-      ListTables-    -- ** Request constructor-    , listTables-    -- ** Request lenses+    -- * Creating a Request+      listTables+    , ListTables+    -- * Request Lenses     , ltExclusiveStartTableName     , ltLimit -    -- * Response-    , ListTablesResponse-    -- ** Response constructor+    -- * Destructuring the Response     , listTablesResponse-    -- ** Response lenses-    , ltrLastEvaluatedTableName-    , ltrTableNames+    , ListTablesResponse+    -- * Response Lenses+    , ltrsLastEvaluatedTableName+    , ltrsTableNames+    , ltrsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data ListTables = ListTables-    { _ltExclusiveStartTableName :: Maybe Text-    , _ltLimit                   :: Maybe Nat-    } deriving (Eq, Ord, Read, Show)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Pager+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'ListTables' constructor.+-- | Represents the input of a /ListTables/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'listTables' smart constructor.+data ListTables = ListTables'+    { _ltExclusiveStartTableName :: !(Maybe Text)+    , _ltLimit                   :: !(Maybe Nat)+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'ListTables' with the minimum fields required to make a request. ----- * 'ltExclusiveStartTableName' @::@ 'Maybe' 'Text'+-- Use one of the following lenses to modify other fields as desired: ----- * 'ltLimit' @::@ 'Maybe' 'Natural'+-- * 'ltExclusiveStartTableName' ---listTables :: ListTables-listTables = ListTables+-- * 'ltLimit'+listTables+    :: ListTables+listTables =+    ListTables'     { _ltExclusiveStartTableName = Nothing-    , _ltLimit                   = Nothing+    , _ltLimit = Nothing     } --- | The first table name that this operation will evaluate. Use the value that--- was returned for /LastEvaluatedTableName/ in a previous operation, so that you--- can obtain the next page of results.+-- | The first table name that this operation will evaluate. Use the value+-- that was returned for /LastEvaluatedTableName/ in a previous operation,+-- so that you can obtain the next page of results. ltExclusiveStartTableName :: Lens' ListTables (Maybe Text)-ltExclusiveStartTableName =-    lens _ltExclusiveStartTableName-        (\s a -> s { _ltExclusiveStartTableName = a })+ltExclusiveStartTableName = lens _ltExclusiveStartTableName (\ s a -> s{_ltExclusiveStartTableName = a});  -- | A maximum number of table names to return. If this parameter is not -- specified, the limit is 100. ltLimit :: Lens' ListTables (Maybe Natural)-ltLimit = lens _ltLimit (\s a -> s { _ltLimit = a }) . mapping _Nat+ltLimit = lens _ltLimit (\ s a -> s{_ltLimit = a}) . mapping _Nat; -data ListTablesResponse = ListTablesResponse-    { _ltrLastEvaluatedTableName :: Maybe Text-    , _ltrTableNames             :: List "TableNames" Text-    } deriving (Eq, Ord, Read, Show)+instance AWSPager ListTables where+        page rq rs+          | stop (rs ^. ltrsLastEvaluatedTableName) = Nothing+          | stop (rs ^. ltrsTableNames) = Nothing+          | otherwise =+            Just $ rq &+              ltExclusiveStartTableName .~+                rs ^. ltrsLastEvaluatedTableName --- | 'ListTablesResponse' constructor.------ The fields accessible through corresponding lenses are:------ * 'ltrLastEvaluatedTableName' @::@ 'Maybe' 'Text'------ * 'ltrTableNames' @::@ ['Text']----listTablesResponse :: ListTablesResponse-listTablesResponse = ListTablesResponse-    { _ltrTableNames             = mempty-    , _ltrLastEvaluatedTableName = Nothing-    }+instance AWSRequest ListTables where+        type Sv ListTables = DynamoDB+        type Rs ListTables = ListTablesResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 ListTablesResponse' <$>+                   (x .?> "LastEvaluatedTableName") <*>+                     (x .?> "TableNames" .!@ mempty)+                     <*> (pure (fromEnum s))) --- | The name of the last table in the current page of results. Use this value as--- the /ExclusiveStartTableName/ in a new request to obtain the next page of--- results, until all the table names are returned.------ If you do not receive a /LastEvaluatedTableName/ value in the response, this--- means that there are no more table names to be retrieved.-ltrLastEvaluatedTableName :: Lens' ListTablesResponse (Maybe Text)-ltrLastEvaluatedTableName =-    lens _ltrLastEvaluatedTableName-        (\s a -> s { _ltrLastEvaluatedTableName = a })+instance ToHeaders ListTables where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.ListTables" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) --- | The names of the tables associated with the current account at the current--- endpoint. The maximum size of this array is 100.------ If /LastEvaluatedTableName/ also appears in the output, you can use this value--- as the /ExclusiveStartTableName/ parameter in a subsequent /ListTables/ request--- and obtain the next page of results.-ltrTableNames :: Lens' ListTablesResponse [Text]-ltrTableNames = lens _ltrTableNames (\s a -> s { _ltrTableNames = a }) . _List+instance ToJSON ListTables where+        toJSON ListTables'{..}+          = object+              ["ExclusiveStartTableName" .=+                 _ltExclusiveStartTableName,+               "Limit" .= _ltLimit]  instance ToPath ListTables where-    toPath = const "/"+        toPath = const "/"  instance ToQuery ListTables where-    toQuery = const mempty--instance ToHeaders ListTables+        toQuery = const mempty -instance ToJSON ListTables where-    toJSON ListTables{..} = object-        [ "ExclusiveStartTableName" .= _ltExclusiveStartTableName-        , "Limit"                   .= _ltLimit-        ]+-- | Represents the output of a /ListTables/ operation.+--+-- /See:/ 'listTablesResponse' smart constructor.+data ListTablesResponse = ListTablesResponse'+    { _ltrsLastEvaluatedTableName :: !(Maybe Text)+    , _ltrsTableNames             :: !(Maybe [Text])+    , _ltrsStatus                 :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic) -instance AWSRequest ListTables where-    type Sv ListTables = DynamoDB-    type Rs ListTables = ListTablesResponse+-- | Creates a value of 'ListTablesResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'ltrsLastEvaluatedTableName'+--+-- * 'ltrsTableNames'+--+-- * 'ltrsStatus'+listTablesResponse+    :: Int -- ^ 'ltrsStatus'+    -> ListTablesResponse+listTablesResponse pStatus_ =+    ListTablesResponse'+    { _ltrsLastEvaluatedTableName = Nothing+    , _ltrsTableNames = Nothing+    , _ltrsStatus = pStatus_+    } -    request  = post "ListTables"-    response = jsonResponse+-- | The name of the last table in the current page of results. Use this+-- value as the /ExclusiveStartTableName/ in a new request to obtain the+-- next page of results, until all the table names are returned.+--+-- If you do not receive a /LastEvaluatedTableName/ value in the response,+-- this means that there are no more table names to be retrieved.+ltrsLastEvaluatedTableName :: Lens' ListTablesResponse (Maybe Text)+ltrsLastEvaluatedTableName = lens _ltrsLastEvaluatedTableName (\ s a -> s{_ltrsLastEvaluatedTableName = a}); -instance FromJSON ListTablesResponse where-    parseJSON = withObject "ListTablesResponse" $ \o -> ListTablesResponse-        <$> o .:? "LastEvaluatedTableName"-        <*> o .:? "TableNames" .!= mempty+-- | The names of the tables associated with the current account at the+-- current endpoint. The maximum size of this array is 100.+--+-- If /LastEvaluatedTableName/ also appears in the output, you can use this+-- value as the /ExclusiveStartTableName/ parameter in a subsequent+-- /ListTables/ request and obtain the next page of results.+ltrsTableNames :: Lens' ListTablesResponse [Text]+ltrsTableNames = lens _ltrsTableNames (\ s a -> s{_ltrsTableNames = a}) . _Default . _Coerce; -instance AWSPager ListTables where-    page rq rs-        | stop (rs ^. ltrLastEvaluatedTableName) = Nothing-        | otherwise = (\x -> rq & ltExclusiveStartTableName ?~ x)-            <$> (rs ^. ltrLastEvaluatedTableName)+-- | The response status code.+ltrsStatus :: Lens' ListTablesResponse Int+ltrsStatus = lens _ltrsStatus (\ s a -> s{_ltrsStatus = a});

@@ -1,576 +1,636 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}  {-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-} +-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- | -- Module      : Network.AWS.DynamoDB.PutItem--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0. -- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental+-- Stability   : auto-generated -- Portability : non-portable (GHC extensions) ----- Derived from AWS service descriptions, licensed under Apache 2.0.---- | Creates a new item, or replaces an old item with a new item. If an item that--- has the same primary key as the new item already exists in the specified--- table, the new item completely replaces the existing item. You can perform a--- conditional put operation (add a new item if one with the specified primary--- key doesn't exist), or replace an existing item if it has certain attribute--- values.+-- Creates a new item, or replaces an old item with a new item. If an item+-- that has the same primary key as the new item already exists in the+-- specified table, the new item completely replaces the existing item. You+-- can perform a conditional put operation (add a new item if one with the+-- specified primary key doesn\'t exist), or replace an existing item if it+-- has certain attribute values. ----- In addition to putting an item, you can also return the item's attribute--- values in the same operation, using the /ReturnValues/ parameter.+-- In addition to putting an item, you can also return the item\'s+-- attribute values in the same operation, using the /ReturnValues/+-- parameter. -- -- When you add an item, the primary key attribute(s) are the only required -- attributes. Attribute values cannot be null. String and Binary type--- attributes must have lengths greater than zero. Set type attributes cannot be--- empty. Requests with empty values will be rejected with a /ValidationException/--- exception.+-- attributes must have lengths greater than zero. Set type attributes+-- cannot be empty. Requests with empty values will be rejected with a+-- /ValidationException/ exception. -- -- You can request that /PutItem/ return either a copy of the original item--- (before the update) or a copy of the updated item (after the update). For--- more information, see the /ReturnValues/ description below.+-- (before the update) or a copy of the updated item (after the update).+-- For more information, see the /ReturnValues/ description below. -- -- To prevent a new item from replacing an existing item, use a conditional--- put operation with /ComparisonOperator/ set to 'NULL' for the primary key--- attribute, or attributes.+-- put operation with /ComparisonOperator/ set to 'NULL' for the primary+-- key attribute, or attributes. ----- For more information about using this API, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items> in the /Amazon DynamoDB Developer Guide/.+-- For more information about using this API, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html Working with Items>+-- in the /Amazon DynamoDB Developer Guide/. ----- <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html>+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html AWS API Reference> for PutItem. module Network.AWS.DynamoDB.PutItem     (-    -- * Request-      PutItem-    -- ** Request constructor-    , putItem-    -- ** Request lenses-    , piConditionExpression-    , piConditionalOperator-    , piExpected+    -- * Creating a Request+      putItem+    , PutItem+    -- * Request Lenses+    , piReturnValues     , piExpressionAttributeNames-    , piExpressionAttributeValues-    , piItem     , piReturnConsumedCapacity+    , piExpressionAttributeValues     , piReturnItemCollectionMetrics-    , piReturnValues+    , piConditionExpression+    , piConditionalOperator+    , piExpected     , piTableName+    , piItem -    -- * Response-    , PutItemResponse-    -- ** Response constructor+    -- * Destructuring the Response     , putItemResponse-    -- ** Response lenses-    , pirAttributes-    , pirConsumedCapacity-    , pirItemCollectionMetrics+    , PutItemResponse+    -- * Response Lenses+    , pirsConsumedCapacity+    , pirsItemCollectionMetrics+    , pirsAttributes+    , pirsStatus     ) where -import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data PutItem = PutItem-    { _piConditionExpression         :: Maybe Text-    , _piConditionalOperator         :: Maybe ConditionalOperator-    , _piExpected                    :: Map Text ExpectedAttributeValue-    , _piExpressionAttributeNames    :: Map Text Text-    , _piExpressionAttributeValues   :: Map Text AttributeValue-    , _piItem                        :: Map Text AttributeValue-    , _piReturnConsumedCapacity      :: Maybe ReturnConsumedCapacity-    , _piReturnItemCollectionMetrics :: Maybe ReturnItemCollectionMetrics-    , _piReturnValues                :: Maybe ReturnValue-    , _piTableName                   :: Text-    } deriving (Eq, Read, Show)+import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response --- | 'PutItem' constructor.+-- | Represents the input of a /PutItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'putItem' smart constructor.+data PutItem = PutItem'+    { _piReturnValues                :: !(Maybe ReturnValue)+    , _piExpressionAttributeNames    :: !(Maybe (Map Text Text))+    , _piReturnConsumedCapacity      :: !(Maybe ReturnConsumedCapacity)+    , _piExpressionAttributeValues   :: !(Maybe (Map Text AttributeValue))+    , _piReturnItemCollectionMetrics :: !(Maybe ReturnItemCollectionMetrics)+    , _piConditionExpression         :: !(Maybe Text)+    , _piConditionalOperator         :: !(Maybe ConditionalOperator)+    , _piExpected                    :: !(Maybe (Map Text ExpectedAttributeValue))+    , _piTableName                   :: !Text+    , _piItem                        :: !(Map Text AttributeValue)+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'PutItem' with the minimum fields required to make a request. ----- * 'piConditionExpression' @::@ 'Maybe' 'Text'+-- Use one of the following lenses to modify other fields as desired: ----- * 'piConditionalOperator' @::@ 'Maybe' 'ConditionalOperator'+-- * 'piReturnValues' ----- * 'piExpected' @::@ 'HashMap' 'Text' 'ExpectedAttributeValue'+-- * 'piExpressionAttributeNames' ----- * 'piExpressionAttributeNames' @::@ 'HashMap' 'Text' 'Text'+-- * 'piReturnConsumedCapacity' ----- * 'piExpressionAttributeValues' @::@ 'HashMap' 'Text' 'AttributeValue'+-- * 'piExpressionAttributeValues' ----- * 'piItem' @::@ 'HashMap' 'Text' 'AttributeValue'+-- * 'piReturnItemCollectionMetrics' ----- * 'piReturnConsumedCapacity' @::@ 'Maybe' 'ReturnConsumedCapacity'+-- * 'piConditionExpression' ----- * 'piReturnItemCollectionMetrics' @::@ 'Maybe' 'ReturnItemCollectionMetrics'+-- * 'piConditionalOperator' ----- * 'piReturnValues' @::@ 'Maybe' 'ReturnValue'+-- * 'piExpected' ----- * 'piTableName' @::@ 'Text'+-- * 'piTableName' ---putItem :: Text -- ^ 'piTableName'-        -> PutItem-putItem p1 = PutItem-    { _piTableName                   = p1-    , _piItem                        = mempty-    , _piExpected                    = mempty-    , _piReturnValues                = Nothing-    , _piReturnConsumedCapacity      = Nothing+-- * 'piItem'+putItem+    :: Text -- ^ 'piTableName'+    -> PutItem+putItem pTableName_ =+    PutItem'+    { _piReturnValues = Nothing+    , _piExpressionAttributeNames = Nothing+    , _piReturnConsumedCapacity = Nothing+    , _piExpressionAttributeValues = Nothing     , _piReturnItemCollectionMetrics = Nothing-    , _piConditionalOperator         = Nothing-    , _piConditionExpression         = Nothing-    , _piExpressionAttributeNames    = mempty-    , _piExpressionAttributeValues   = mempty+    , _piConditionExpression = Nothing+    , _piConditionalOperator = Nothing+    , _piExpected = Nothing+    , _piTableName = pTableName_+    , _piItem = mempty     } --- | A condition that must be satisfied in order for a conditional /PutItem/--- operation to succeed.------ An expression can contain any of the following:------ Boolean functions: 'attribute_exists | attribute_not_exists | contains |begins_with'------ These function names are case-sensitive.------ Comparison operators: ' = | <> | < | > | <= | >= | BETWEEN | IN'------ Logical operators: 'AND | OR | NOT'+-- | Use /ReturnValues/ if you want to get the item attributes as they+-- appeared before they were updated with the /PutItem/ request. For+-- /PutItem/, the valid values are: ----- For more information on condition expressions, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>--- in the /Amazon DynamoDB Developer Guide/.+-- -   'NONE' - If /ReturnValues/ is not specified, or if its value is+--     'NONE', then nothing is returned. (This setting is the default for+--     /ReturnValues/.) ----- /ConditionExpression/ replaces the legacy /ConditionalOperator/ and /Expected/--- parameters.+-- -   'ALL_OLD' - If /PutItem/ overwrote an attribute name-value pair,+--     then the content of the old item is returned. ---piConditionExpression :: Lens' PutItem (Maybe Text)-piConditionExpression =-    lens _piConditionExpression (\s a -> s { _piConditionExpression = a })+-- Other \"Valid Values\" are not relevant to PutItem.+piReturnValues :: Lens' PutItem (Maybe ReturnValue)+piReturnValues = lens _piReturnValues (\ s a -> s{_piReturnValues = a}); --- | This is a legacy parameter, for backward compatibility. New applications--- should use /ConditionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.------ A logical operator to apply to the conditions in the /Expected/ map:+-- | One or more substitution tokens for attribute names in an expression.+-- The following are some use cases for using /ExpressionAttributeNames/: ----- 'AND' - If all of the conditions evaluate to true, then the entire map--- evaluates to true.+-- -   To access an attribute whose name conflicts with a DynamoDB reserved+--     word. ----- 'OR' - If at least one of the conditions evaluate to true, then the entire map--- evaluates to true.+-- -   To create a placeholder for repeating occurrences of an attribute+--     name in an expression. ----- If you omit /ConditionalOperator/, then 'AND' is the default.+-- -   To prevent special characters in an attribute name from being+--     misinterpreted in an expression. ----- The operation will succeed only if the entire map evaluates to true.+-- Use the __#__ character in an expression to dereference an attribute+-- name. For example, consider the following attribute name: ----- This parameter does not support attributes of type List or Map.+-- -   'Percentile' ---piConditionalOperator :: Lens' PutItem (Maybe ConditionalOperator)-piConditionalOperator =-    lens _piConditionalOperator (\s a -> s { _piConditionalOperator = a })---- | This is a legacy parameter, for backward compatibility. New applications--- should use /ConditionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.+-- The name of this attribute conflicts with a reserved word, so it cannot+-- be used directly in an expression. (For the complete list of reserved+-- words, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words>+-- in the /Amazon DynamoDB Developer Guide/). To work around this, you+-- could specify the following for /ExpressionAttributeNames/: ----- A map of attribute/condition pairs. /Expected/ provides a conditional block--- for the /PutItem/ operation.+-- -   '{\"#P\":\"Percentile\"}' ----- This parameter does not support attributes of type List or Map.+-- You could then use this substitution in an expression, as in this+-- example: ----- Each element of /Expected/ consists of an attribute name, a comparison--- operator, and one or more values. DynamoDB compares the attribute with the--- value(s) you supplied, using the comparison operator. For each /Expected/--- element, the result of the evaluation is either true or false.+-- -   '#P = :val' ----- If you specify more than one element in the /Expected/ map, then by default--- all of the conditions must evaluate to true. In other words, the conditions--- are ANDed together. (You can use the /ConditionalOperator/ parameter to OR the--- conditions instead. If you do this, then at least one of the conditions must--- evaluate to true, rather than all of them.)+-- Tokens that begin with the __:__ character are /expression attribute+-- values/, which are placeholders for the actual value at runtime. ----- If the /Expected/ map evaluates to true, then the conditional operation--- succeeds; otherwise, it fails.+-- For more information on expression attribute names, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+-- in the /Amazon DynamoDB Developer Guide/.+piExpressionAttributeNames :: Lens' PutItem (HashMap Text Text)+piExpressionAttributeNames = lens _piExpressionAttributeNames (\ s a -> s{_piExpressionAttributeNames = a}) . _Default . _Map;++-- | Undocumented member.+piReturnConsumedCapacity :: Lens' PutItem (Maybe ReturnConsumedCapacity)+piReturnConsumedCapacity = lens _piReturnConsumedCapacity (\ s a -> s{_piReturnConsumedCapacity = a});++-- | One or more values that can be substituted in an expression. ----- /Expected/ contains the following:+-- Use the __:__ (colon) character in an expression to dereference an+-- attribute value. For example, suppose that you wanted to check whether+-- the value of the /ProductStatus/ attribute was one of the following: ----- /AttributeValueList/ - One or more values to evaluate against the supplied--- attribute. The number of values in the list depends on the /ComparisonOperator/--- being used.+-- 'Available | Backordered | Discontinued' ----- For type Number, value comparisons are numeric.+-- You would first need to specify /ExpressionAttributeValues/ as follows: ----- String value comparisons for greater than, equals, or less than are based on--- ASCII character code values. For example, 'a' is greater than 'A', and 'a' is--- greater than 'B'. For a list of code values, see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>.+-- '{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }' ----- For type Binary, DynamoDB treats each byte of the binary data as unsigned--- when it compares binary values.+-- You could then use these values in an expression, such as this: ----- /ComparisonOperator/ - A comparator for evaluating attributes in the /AttributeValueList/. When performing the comparison, DynamoDB uses strongly consistent reads.+-- 'ProductStatus IN (:avail, :back, :disc)' ----- The following comparison operators are available:+-- For more information on expression attribute values, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>+-- in the /Amazon DynamoDB Developer Guide/.+piExpressionAttributeValues :: Lens' PutItem (HashMap Text AttributeValue)+piExpressionAttributeValues = lens _piExpressionAttributeValues (\ s a -> s{_piExpressionAttributeValues = a}) . _Default . _Map;++-- | Determines whether item collection metrics are returned. If set to+-- 'SIZE', the response includes statistics about item collections, if any,+-- that were modified during the operation are returned in the response. If+-- set to 'NONE' (the default), no statistics are returned.+piReturnItemCollectionMetrics :: Lens' PutItem (Maybe ReturnItemCollectionMetrics)+piReturnItemCollectionMetrics = lens _piReturnItemCollectionMetrics (\ s a -> s{_piReturnItemCollectionMetrics = a});++-- | A condition that must be satisfied in order for a conditional /PutItem/+-- operation to succeed. ----- 'EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS |BEGINS_WITH | IN | BETWEEN'+-- An expression can contain any of the following: ----- The following are descriptions of each comparison operator.+-- -   Functions:+--     'attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size' ----- 'EQ' : Equal. 'EQ' is supported for all datatypes, including lists and maps.+--     These function names are case-sensitive. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, Binary, String Set, Number Set, or Binary Set. If an item--- contains an /AttributeValue/ element of a different type than the one provided--- in the request, the value does not match. For example, '{"S":"6"}' does not--- equal '{"N":"6"}'. Also, '{"N":"6"}' does not equal '{"NS":["6", "2", "1"]}'.+-- -   Comparison operators: ' = | \<> | \< | > | \<= | >= | BETWEEN | IN' --+-- -   Logical operators: 'AND | OR | NOT' --+-- For more information on condition expressions, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>+-- in the /Amazon DynamoDB Developer Guide/. ----- 'NE' : Not equal. 'NE' is supported for all datatypes, including lists and--- maps.+-- /ConditionExpression/ replaces the legacy /ConditionalOperator/ and+-- /Expected/ parameters.+piConditionExpression :: Lens' PutItem (Maybe Text)+piConditionExpression = lens _piConditionExpression (\ s a -> s{_piConditionExpression = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /ConditionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception. ----- /AttributeValueList/ can contain only one /AttributeValue/ of type String,--- Number, Binary, String Set, Number Set, or Binary Set. If an item contains an /AttributeValue/ of a different type than the one provided in the request, the--- value does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not equal '{"NS":["6", "2", "1"]}'.+-- A logical operator to apply to the conditions in the /Expected/ map: --+-- -   'AND' - If all of the conditions evaluate to true, then the entire+--     map evaluates to true. --+-- -   'OR' - If at least one of the conditions evaluate to true, then the+--     entire map evaluates to true. ----- 'LE' : Less than or equal.+-- If you omit /ConditionalOperator/, then 'AND' is the default. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- The operation will succeed only if the entire map evaluates to true. --+-- This parameter does not support attributes of type List or Map.+piConditionalOperator :: Lens' PutItem (Maybe ConditionalOperator)+piConditionalOperator = lens _piConditionalOperator (\ s a -> s{_piConditionalOperator = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /ConditionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception. --+-- A map of attribute\/condition pairs. /Expected/ provides a conditional+-- block for the /PutItem/ operation. ----- 'LT' : Less than.+-- This parameter does not support attributes of type List or Map. ----- /AttributeValueList/ can contain only one /AttributeValue/ of type String,--- Number, or Binary (not a set type). If an item contains an /AttributeValue/--- element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- Each element of /Expected/ consists of an attribute name, a comparison+-- operator, and one or more values. DynamoDB compares the attribute with+-- the value(s) you supplied, using the comparison operator. For each+-- /Expected/ element, the result of the evaluation is either true or+-- false. --+-- If you specify more than one element in the /Expected/ map, then by+-- default all of the conditions must evaluate to true. In other words, the+-- conditions are ANDed together. (You can use the /ConditionalOperator/+-- parameter to OR the conditions instead. If you do this, then at least+-- one of the conditions must evaluate to true, rather than all of them.) --+-- If the /Expected/ map evaluates to true, then the conditional operation+-- succeeds; otherwise, it fails. ----- 'GE' : Greater than or equal.+-- /Expected/ contains the following: ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- -   /AttributeValueList/ - One or more values to evaluate against the+--     supplied attribute. The number of values in the list depends on the+--     /ComparisonOperator/ being used. --+--     For type Number, value comparisons are numeric. --+--     String value comparisons for greater than, equals, or less than are+--     based on ASCII character code values. For example, 'a' is greater+--     than 'A', and 'a' is greater than 'B'. For a list of code values,+--     see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>. ----- 'GT' : Greater than.+--     For type Binary, DynamoDB treats each byte of the binary data as+--     unsigned when it compares binary values. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.+-- -   /ComparisonOperator/ - A comparator for evaluating attributes in the+--     /AttributeValueList/. When performing the comparison, DynamoDB uses+--     strongly consistent reads. --+--     The following comparison operators are available: --+--     'EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN' ----- 'NOT_NULL' : The attribute exists. 'NOT_NULL' is supported for all datatypes,--- including lists and maps.+--     The following are descriptions of each comparison operator. ----- This operator tests for the existence of an attribute, not its data type. If--- the data type of attribute "'a'" is null, and you evaluate it using 'NOT_NULL',--- the result is a Boolean /true/. This result is because the attribute "'a'"--- exists; its data type is not relevant to the 'NOT_NULL' comparison operator.+--     -   'EQ' : Equal. 'EQ' is supported for all datatypes, including+--         lists and maps. ----- 'NULL' : The attribute does not exist. 'NULL' is supported for all datatypes,--- including lists and maps.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, Binary, String Set, Number Set,+--         or Binary Set. If an item contains an /AttributeValue/ element+--         of a different type than the one provided in the request, the+--         value does not match. For example, '{\"S\":\"6\"}' does not+--         equal '{\"N\":\"6\"}'. Also, '{\"N\":\"6\"}' does not equal+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- This operator tests for the nonexistence of an attribute, not its data type.--- If the data type of attribute "'a'" is null, and you evaluate it using 'NULL',--- the result is a Boolean /false/. This is because the attribute "'a'" exists; its--- data type is not relevant to the 'NULL' comparison operator.+--     -   'NE' : Not equal. 'NE' is supported for all datatypes, including+--         lists and maps. ----- 'CONTAINS' : Checks for a subsequence, or value in a set.+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String, Number, Binary, String Set, Number Set, or Binary+--         Set. If an item contains an /AttributeValue/ of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not equal+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If the target attribute of the--- comparison is of type String, then the operator checks for a substring match.--- If the target attribute of the comparison is of type Binary, then the--- operator looks for a subsequence of the target that matches the input. If the--- target attribute of the comparison is a set ("'SS'", "'NS'", or "'BS'"), then the--- operator evaluates to true if it finds an exact match with any member of the--- set.+--     -   'LE' : Less than or equal. ----- CONTAINS is supported for lists: When evaluating "'a CONTAINS b'", "'a'" can be--- a list; however, "'b'" cannot be a set, a map, or a list.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- 'NOT_CONTAINS' : Checks for absence of a subsequence, or absence of a value--- in a set.+--     -   'LT' : Less than. ----- /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If the target attribute of the--- comparison is a String, then the operator checks for the absence of a--- substring match. If the target attribute of the comparison is Binary, then--- the operator checks for the absence of a subsequence of the target that--- matches the input. If the target attribute of the comparison is a set ("'SS'", "'NS'", or "'BS'"), then the operator evaluates to true if it /does not/ find an--- exact match with any member of the set.+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String, Number, or Binary (not a set type). If an item+--         contains an /AttributeValue/ element of a different type than+--         the one provided in the request, the value does not match. For+--         example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'. Also,+--         '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- NOT_CONTAINS is supported for lists: When evaluating "'a NOT CONTAINS b'", "'a'"--- can be a list; however, "'b'" cannot be a set, a map, or a list.+--     -   'GE' : Greater than or equal. ----- 'BEGINS_WITH' : Checks for a prefix.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. ----- /AttributeValueList/ can contain only one /AttributeValue/ of type String or--- Binary (not a Number or a set type). The target attribute of the comparison--- must be of type String or Binary (not a Number or a set type).+--     -   'GT' : Greater than. --+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'. --+--     -   'NOT_NULL' : The attribute exists. 'NOT_NULL' is supported for+--         all datatypes, including lists and maps. ----- 'IN' : Checks for matching elements within two sets.+--         This operator tests for the existence of an attribute, not its+--         data type. If the data type of attribute \"'a'\" is null, and+--         you evaluate it using 'NOT_NULL', the result is a Boolean+--         /true/. This result is because the attribute \"'a'\" exists; its+--         data type is not relevant to the 'NOT_NULL' comparison operator. ----- /AttributeValueList/ can contain one or more /AttributeValue/ elements of type--- String, Number, or Binary (not a set type). These attributes are compared--- against an existing set type attribute of an item. If any elements of the--- input set are present in the item attribute, the expression evaluates to true.+--     -   'NULL' : The attribute does not exist. 'NULL' is supported for+--         all datatypes, including lists and maps. ----- 'BETWEEN' : Greater than or equal to the first value, and less than or equal--- to the second value.+--         This operator tests for the nonexistence of an attribute, not+--         its data type. If the data type of attribute \"'a'\" is null,+--         and you evaluate it using 'NULL', the result is a Boolean+--         /false/. This is because the attribute \"'a'\" exists; its data+--         type is not relevant to the 'NULL' comparison operator. ----- /AttributeValueList/ must contain two /AttributeValue/ elements of the same--- type, either String, Number, or Binary (not a set type). A target attribute--- matches if the target value is greater than, or equal to, the first element--- and less than, or equal to, the second element. If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not compare to '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'+--     -   'CONTAINS' : Checks for a subsequence, or value in a set. ----- For usage examples of /AttributeValueList/ and /ComparisonOperator/, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html Legacy Conditional Parameters> in the /Amazon DynamoDB Developer Guide/.+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         the target attribute of the comparison is of type String, then+--         the operator checks for a substring match. If the target+--         attribute of the comparison is of type Binary, then the operator+--         looks for a subsequence of the target that matches the input. If+--         the target attribute of the comparison is a set (\"'SS'\",+--         \"'NS'\", or \"'BS'\"), then the operator evaluates to true if+--         it finds an exact match with any member of the set. ----- For backward compatibility with previous DynamoDB releases, the following--- parameters can be used instead of /AttributeValueList/ and /ComparisonOperator/:+--         CONTAINS is supported for lists: When evaluating+--         \"'a CONTAINS b'\", \"'a'\" can be a list; however, \"'b'\"+--         cannot be a set, a map, or a list. ----- /Value/ - A value for DynamoDB to compare with an attribute.+--     -   'NOT_CONTAINS' : Checks for absence of a subsequence, or absence+--         of a value in a set. ----- /Exists/ - A Boolean value that causes DynamoDB to evaluate the value before--- attempting the conditional operation:+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         the target attribute of the comparison is a String, then the+--         operator checks for the absence of a substring match. If the+--         target attribute of the comparison is Binary, then the operator+--         checks for the absence of a subsequence of the target that+--         matches the input. If the target attribute of the comparison is+--         a set (\"'SS'\", \"'NS'\", or \"'BS'\"), then the operator+--         evaluates to true if it /does not/ find an exact match with any+--         member of the set. ----- If /Exists/ is 'true', DynamoDB will check to see if that attribute value--- already exists in the table. If it is found, then the condition evaluates to--- true; otherwise the condition evaluate to false.+--         NOT_CONTAINS is supported for lists: When evaluating+--         \"'a NOT CONTAINS b'\", \"'a'\" can be a list; however, \"'b'\"+--         cannot be a set, a map, or a list. ----- If /Exists/ is 'false', DynamoDB assumes that the attribute value does /not/--- exist in the table. If in fact the value does not exist, then the assumption--- is valid and the condition evaluates to true. If the value is found, despite--- the assumption that it does not exist, the condition evaluates to false.+--     -   'BEGINS_WITH' : Checks for a prefix. ----- Note that the default value for /Exists/ is 'true'.+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String or Binary (not a Number or a set type). The target+--         attribute of the comparison must be of type String or Binary+--         (not a Number or a set type). ----- The /Value/ and /Exists/ parameters are incompatible with /AttributeValueList/--- and /ComparisonOperator/. Note that if you use both sets of parameters at once,--- DynamoDB will return a /ValidationException/ exception.-piExpected :: Lens' PutItem (HashMap Text ExpectedAttributeValue)-piExpected = lens _piExpected (\s a -> s { _piExpected = a }) . _Map---- | One or more substitution tokens for attribute names in an expression. The--- following are some use cases for using /ExpressionAttributeNames/:+--     -   'IN' : Checks for matching elements within two sets. ----- To access an attribute whose name conflicts with a DynamoDB reserved word.+--         /AttributeValueList/ can contain one or more /AttributeValue/+--         elements of type String, Number, or Binary (not a set type).+--         These attributes are compared against an existing set type+--         attribute of an item. If any elements of the input set are+--         present in the item attribute, the expression evaluates to true. ----- To create a placeholder for repeating occurrences of an attribute name in--- an expression.+--     -   'BETWEEN' : Greater than or equal to the first value, and less+--         than or equal to the second value. ----- To prevent special characters in an attribute name from being--- misinterpreted in an expression.+--         /AttributeValueList/ must contain two /AttributeValue/ elements+--         of the same type, either String, Number, or Binary (not a set+--         type). A target attribute matches if the target value is greater+--         than, or equal to, the first element and less than, or equal to,+--         the second element. If an item contains an /AttributeValue/+--         element of a different type than the one provided in the+--         request, the value does not match. For example, '{\"S\":\"6\"}'+--         does not compare to '{\"N\":\"6\"}'. Also, '{\"N\":\"6\"}' does+--         not compare to '{\"NS\":[\"6\", \"2\", \"1\"]}' ----- Use the # character in an expression to dereference an attribute name. For--- example, consider the following attribute name:+-- For usage examples of /AttributeValueList/ and /ComparisonOperator/, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html Legacy Conditional Parameters>+-- in the /Amazon DynamoDB Developer Guide/. ----- 'Percentile'+-- For backward compatibility with previous DynamoDB releases, the+-- following parameters can be used instead of /AttributeValueList/ and+-- /ComparisonOperator/: ----- The name of this attribute conflicts with a reserved word, so it cannot be--- used directly in an expression. (For the complete list of reserved words, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words> in the /Amazon DynamoDB Developer Guide/). To work around this,--- you could specify the following for /ExpressionAttributeNames/:+-- -   /Value/ - A value for DynamoDB to compare with an attribute. ----- '{"#P":"Percentile"}'+-- -   /Exists/ - A Boolean value that causes DynamoDB to evaluate the+--     value before attempting the conditional operation: ----- You could then use this substitution in an expression, as in this example:+--     -   If /Exists/ is 'true', DynamoDB will check to see if that+--         attribute value already exists in the table. If it is found,+--         then the condition evaluates to true; otherwise the condition+--         evaluate to false. ----- '#P = :val'+--     -   If /Exists/ is 'false', DynamoDB assumes that the attribute+--         value does /not/ exist in the table. If in fact the value does+--         not exist, then the assumption is valid and the condition+--         evaluates to true. If the value is found, despite the assumption+--         that it does not exist, the condition evaluates to false. ----- Tokens that begin with the : character are /expression attribute values/,--- which are placeholders for the actual value at runtime.+--     Note that the default value for /Exists/ is 'true'. ----- For more information on expression attribute names, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.-piExpressionAttributeNames :: Lens' PutItem (HashMap Text Text)-piExpressionAttributeNames =-    lens _piExpressionAttributeNames-        (\s a -> s { _piExpressionAttributeNames = a })-            . _Map+-- The /Value/ and /Exists/ parameters are incompatible with+-- /AttributeValueList/ and /ComparisonOperator/. Note that if you use both+-- sets of parameters at once, DynamoDB will return a /ValidationException/+-- exception.+piExpected :: Lens' PutItem (HashMap Text ExpectedAttributeValue)+piExpected = lens _piExpected (\ s a -> s{_piExpected = a}) . _Default . _Map; --- | One or more values that can be substituted in an expression.------ Use the : (colon) character in an expression to dereference an attribute--- value. For example, suppose that you wanted to check whether the value of the /ProductStatus/ attribute was one of the following:------ 'Available | Backordered | Discontinued'------ You would first need to specify /ExpressionAttributeValues/ as follows:------ '{ ":avail":{"S":"Available"}, ":back":{"S":"Backordered"},":disc":{"S":"Discontinued"} }'------ You could then use these values in an expression, such as this:------ 'ProductStatus IN (:avail, :back, :disc)'------ For more information on expression attribute values, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.-piExpressionAttributeValues :: Lens' PutItem (HashMap Text AttributeValue)-piExpressionAttributeValues =-    lens _piExpressionAttributeValues-        (\s a -> s { _piExpressionAttributeValues = a })-            . _Map+-- | The name of the table to contain the item.+piTableName :: Lens' PutItem Text+piTableName = lens _piTableName (\ s a -> s{_piTableName = a}); --- | A map of attribute name/value pairs, one for each attribute. Only the primary--- key attributes are required; you can optionally provide other attribute--- name-value pairs for the item.+-- | A map of attribute name\/value pairs, one for each attribute. Only the+-- primary key attributes are required; you can optionally provide other+-- attribute name-value pairs for the item. -- -- You must provide all of the attributes for the primary key. For example,--- with a hash type primary key, you only need to provide the hash attribute.--- For a hash-and-range type primary key, you must provide both the hash--- attribute and the range attribute.+-- with a hash type primary key, you only need to provide the hash+-- attribute. For a hash-and-range type primary key, you must provide both+-- the hash attribute and the range attribute. ----- If you specify any attributes that are part of an index key, then the data--- types for those attributes must match those of the schema in the table's--- attribute definition.+-- If you specify any attributes that are part of an index key, then the+-- data types for those attributes must match those of the schema in the+-- table\'s attribute definition. ----- For more information about primary keys, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey Primary Key> in the /AmazonDynamoDB Developer Guide/.+-- For more information about primary keys, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey Primary Key>+-- in the /Amazon DynamoDB Developer Guide/. -- -- Each element in the /Item/ map is an /AttributeValue/ object. piItem :: Lens' PutItem (HashMap Text AttributeValue)-piItem = lens _piItem (\s a -> s { _piItem = a }) . _Map+piItem = lens _piItem (\ s a -> s{_piItem = a}) . _Map; -piReturnConsumedCapacity :: Lens' PutItem (Maybe ReturnConsumedCapacity)-piReturnConsumedCapacity =-    lens _piReturnConsumedCapacity-        (\s a -> s { _piReturnConsumedCapacity = a })+instance AWSRequest PutItem where+        type Sv PutItem = DynamoDB+        type Rs PutItem = PutItemResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 PutItemResponse' <$>+                   (x .?> "ConsumedCapacity") <*>+                     (x .?> "ItemCollectionMetrics")+                     <*> (x .?> "Attributes" .!@ mempty)+                     <*> (pure (fromEnum s))) --- | A value that if set to 'SIZE', the response includes statistics about item--- collections, if any, that were modified during the operation are returned in--- the response. If set to 'NONE' (the default), no statistics are returned.-piReturnItemCollectionMetrics :: Lens' PutItem (Maybe ReturnItemCollectionMetrics)-piReturnItemCollectionMetrics =-    lens _piReturnItemCollectionMetrics-        (\s a -> s { _piReturnItemCollectionMetrics = a })+instance ToHeaders PutItem where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.PutItem" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)]) --- | Use /ReturnValues/ if you want to get the item attributes as they appeared--- before they were updated with the /PutItem/ request. For /PutItem/, the valid--- values are:------ 'NONE' - If /ReturnValues/ is not specified, or if its value is 'NONE', then--- nothing is returned. (This setting is the default for /ReturnValues/.)------ 'ALL_OLD' - If /PutItem/ overwrote an attribute name-value pair, then the--- content of the old item is returned.-------piReturnValues :: Lens' PutItem (Maybe ReturnValue)-piReturnValues = lens _piReturnValues (\s a -> s { _piReturnValues = a })+instance ToJSON PutItem where+        toJSON PutItem'{..}+          = object+              ["ReturnValues" .= _piReturnValues,+               "ExpressionAttributeNames" .=+                 _piExpressionAttributeNames,+               "ReturnConsumedCapacity" .=+                 _piReturnConsumedCapacity,+               "ExpressionAttributeValues" .=+                 _piExpressionAttributeValues,+               "ReturnItemCollectionMetrics" .=+                 _piReturnItemCollectionMetrics,+               "ConditionExpression" .= _piConditionExpression,+               "ConditionalOperator" .= _piConditionalOperator,+               "Expected" .= _piExpected,+               "TableName" .= _piTableName, "Item" .= _piItem] --- | The name of the table to contain the item.-piTableName :: Lens' PutItem Text-piTableName = lens _piTableName (\s a -> s { _piTableName = a })+instance ToPath PutItem where+        toPath = const "/" -data PutItemResponse = PutItemResponse-    { _pirAttributes            :: Map Text AttributeValue-    , _pirConsumedCapacity      :: Maybe ConsumedCapacity-    , _pirItemCollectionMetrics :: Maybe ItemCollectionMetrics-    } deriving (Eq, Read, Show)+instance ToQuery PutItem where+        toQuery = const mempty --- | 'PutItemResponse' constructor.+-- | Represents the output of a /PutItem/ operation. ----- The fields accessible through corresponding lenses are:+-- /See:/ 'putItemResponse' smart constructor.+data PutItemResponse = PutItemResponse'+    { _pirsConsumedCapacity      :: !(Maybe ConsumedCapacity)+    , _pirsItemCollectionMetrics :: !(Maybe ItemCollectionMetrics)+    , _pirsAttributes            :: !(Maybe (Map Text AttributeValue))+    , _pirsStatus                :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'PutItemResponse' with the minimum fields required to make a request. ----- * 'pirAttributes' @::@ 'HashMap' 'Text' 'AttributeValue'+-- Use one of the following lenses to modify other fields as desired: ----- * 'pirConsumedCapacity' @::@ 'Maybe' 'ConsumedCapacity'+-- * 'pirsConsumedCapacity' ----- * 'pirItemCollectionMetrics' @::@ 'Maybe' 'ItemCollectionMetrics'+-- * 'pirsItemCollectionMetrics' ---putItemResponse :: PutItemResponse-putItemResponse = PutItemResponse-    { _pirAttributes            = mempty-    , _pirConsumedCapacity      = Nothing-    , _pirItemCollectionMetrics = Nothing+-- * 'pirsAttributes'+--+-- * 'pirsStatus'+putItemResponse+    :: Int -- ^ 'pirsStatus'+    -> PutItemResponse+putItemResponse pStatus_ =+    PutItemResponse'+    { _pirsConsumedCapacity = Nothing+    , _pirsItemCollectionMetrics = Nothing+    , _pirsAttributes = Nothing+    , _pirsStatus = pStatus_     } --- | The attribute values as they appeared before the /PutItem/ operation, but only--- if /ReturnValues/ is specified as 'ALL_OLD' in the request. Each element consists--- of an attribute name and an attribute value.-pirAttributes :: Lens' PutItemResponse (HashMap Text AttributeValue)-pirAttributes = lens _pirAttributes (\s a -> s { _pirAttributes = a }) . _Map--pirConsumedCapacity :: Lens' PutItemResponse (Maybe ConsumedCapacity)-pirConsumedCapacity =-    lens _pirConsumedCapacity (\s a -> s { _pirConsumedCapacity = a })+-- | Undocumented member.+pirsConsumedCapacity :: Lens' PutItemResponse (Maybe ConsumedCapacity)+pirsConsumedCapacity = lens _pirsConsumedCapacity (\ s a -> s{_pirsConsumedCapacity = a});  -- | Information about item collections, if any, that were affected by the--- operation. /ItemCollectionMetrics/ is only returned if the request asked for--- it. If the table does not have any local secondary indexes, this information--- is not returned in the response.+-- operation. /ItemCollectionMetrics/ is only returned if the request asked+-- for it. If the table does not have any local secondary indexes, this+-- information is not returned in the response. -- -- Each /ItemCollectionMetrics/ element consists of: ----- /ItemCollectionKey/ - The hash key value of the item collection. This is the--- same as the hash key of the item.------ /SizeEstimateRange/ - An estimate of item collection size, in gigabytes. This--- value is a two-element array containing a lower bound and an upper bound for--- the estimate. The estimate includes the size of all the items in the table,--- plus the size of all attributes projected into all of the local secondary--- indexes on that table. Use this estimate to measure whether a local secondary--- index is approaching its size limit.+-- -   /ItemCollectionKey/ - The hash key value of the item collection.+--     This is the same as the hash key of the item. ----- The estimate is subject to change over time; therefore, do not rely on the--- precision or accuracy of the estimate.+-- -   /SizeEstimateRange/ - An estimate of item collection size, in+--     gigabytes. This value is a two-element array containing a lower+--     bound and an upper bound for the estimate. The estimate includes the+--     size of all the items in the table, plus the size of all attributes+--     projected into all of the local secondary indexes on that table. Use+--     this estimate to measure whether a local secondary index is+--     approaching its size limit. --+--     The estimate is subject to change over time; therefore, do not rely+--     on the precision or accuracy of the estimate. ---pirItemCollectionMetrics :: Lens' PutItemResponse (Maybe ItemCollectionMetrics)-pirItemCollectionMetrics =-    lens _pirItemCollectionMetrics-        (\s a -> s { _pirItemCollectionMetrics = a })--instance ToPath PutItem where-    toPath = const "/"--instance ToQuery PutItem where-    toQuery = const mempty--instance ToHeaders PutItem--instance ToJSON PutItem where-    toJSON PutItem{..} = object-        [ "TableName"                   .= _piTableName-        , "Item"                        .= _piItem-        , "Expected"                    .= _piExpected-        , "ReturnValues"                .= _piReturnValues-        , "ReturnConsumedCapacity"      .= _piReturnConsumedCapacity-        , "ReturnItemCollectionMetrics" .= _piReturnItemCollectionMetrics-        , "ConditionalOperator"         .= _piConditionalOperator-        , "ConditionExpression"         .= _piConditionExpression-        , "ExpressionAttributeNames"    .= _piExpressionAttributeNames-        , "ExpressionAttributeValues"   .= _piExpressionAttributeValues-        ]--instance AWSRequest PutItem where-    type Sv PutItem = DynamoDB-    type Rs PutItem = PutItemResponse+pirsItemCollectionMetrics :: Lens' PutItemResponse (Maybe ItemCollectionMetrics)+pirsItemCollectionMetrics = lens _pirsItemCollectionMetrics (\ s a -> s{_pirsItemCollectionMetrics = a}); -    request  = post "PutItem"-    response = jsonResponse+-- | The attribute values as they appeared before the /PutItem/ operation,+-- but only if /ReturnValues/ is specified as 'ALL_OLD' in the request.+-- Each element consists of an attribute name and an attribute value.+pirsAttributes :: Lens' PutItemResponse (HashMap Text AttributeValue)+pirsAttributes = lens _pirsAttributes (\ s a -> s{_pirsAttributes = a}) . _Default . _Map; -instance FromJSON PutItemResponse where-    parseJSON = withObject "PutItemResponse" $ \o -> PutItemResponse-        <$> o .:? "Attributes" .!= mempty-        <*> o .:? "ConsumedCapacity"-        <*> o .:? "ItemCollectionMetrics"+-- | The response status code.+pirsStatus :: Lens' PutItemResponse Int+pirsStatus = lens _pirsStatus (\ s a -> s{_pirsStatus = a});

@@ -1,759 +1,848 @@-{-# LANGUAGE DataKinds                   #-}-{-# LANGUAGE DeriveGeneric               #-}-{-# LANGUAGE FlexibleInstances           #-}-{-# LANGUAGE GeneralizedNewtypeDeriving  #-}-{-# LANGUAGE LambdaCase                  #-}-{-# LANGUAGE NoImplicitPrelude           #-}-{-# LANGUAGE OverloadedStrings           #-}-{-# LANGUAGE RecordWildCards             #-}-{-# LANGUAGE TypeFamilies                #-}--{-# OPTIONS_GHC -fno-warn-unused-imports #-}---- Module      : Network.AWS.DynamoDB.Query--- Copyright   : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>--- License     : This Source Code Form is subject to the terms of---               the Mozilla Public License, v. 2.0.---               A copy of the MPL can be found in the LICENSE file or---               you can obtain it at http://mozilla.org/MPL/2.0/.--- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>--- Stability   : experimental--- Portability : non-portable (GHC extensions)------ Derived from AWS service descriptions, licensed under Apache 2.0.---- | A /Query/ operation uses the primary key of a table or a secondary index to--- directly access items from that table or index.------ Use the /KeyConditionExpression/ parameter to provide a specific hash key--- value. The /Query/ operation will return all of the items from the table or--- index with that hash key value. You can optionally narrow the scope of the /Query/ by specifying a range key value and a comparison operator in the /KeyConditionExpression/. You can use the /ScanIndexForward/ parameter to get results in forward or--- reverse order, by range key or by index key.------ Queries that do not return results consume the minimum number of read--- capacity units for that type of read operation.------ If the total number of items meeting the query criteria exceeds the result--- set size limit of 1 MB, the query stops and results are returned to the user--- with /LastEvaluatedKey/ to continue the query in a subsequent operation. Unlike--- a /Scan/ operation, a /Query/ operation never returns both an empty result set--- and a /LastEvaluatedKey/. The /LastEvaluatedKey/ is only provided if the results--- exceed 1 MB, or if you have used /Limit/.------ You can query a table, a local secondary index, or a global secondary index.--- For a query on a table or on a local secondary index, you can set /ConsistentRead/ to true and obtain a strongly consistent result. Global secondary indexes--- support eventually consistent reads only, so do not specify /ConsistentRead/--- when querying a global secondary index.------ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html>-module Network.AWS.DynamoDB.Query-    (-    -- * Request-      Query-    -- ** Request constructor-    , query-    -- ** Request lenses-    , qAttributesToGet-    , qConditionalOperator-    , qConsistentRead-    , qExclusiveStartKey-    , qExpressionAttributeNames-    , qExpressionAttributeValues-    , qFilterExpression-    , qIndexName-    , qKeyConditionExpression-    , qKeyConditions-    , qLimit-    , qProjectionExpression-    , qQueryFilter-    , qReturnConsumedCapacity-    , qScanIndexForward-    , qSelect-    , qTableName--    -- * Response-    , QueryResponse-    -- ** Response constructor-    , queryResponse-    -- ** Response lenses-    , qrConsumedCapacity-    , qrCount-    , qrItems-    , qrLastEvaluatedKey-    , qrScannedCount-    ) where--import Network.AWS.Data (Object)-import Network.AWS.Prelude-import Network.AWS.Request.JSON-import Network.AWS.DynamoDB.Types-import qualified GHC.Exts--data Query = Query-    { _qAttributesToGet           :: List1 "AttributesToGet" Text-    , _qConditionalOperator       :: Maybe ConditionalOperator-    , _qConsistentRead            :: Maybe Bool-    , _qExclusiveStartKey         :: Map Text AttributeValue-    , _qExpressionAttributeNames  :: Map Text Text-    , _qExpressionAttributeValues :: Map Text AttributeValue-    , _qFilterExpression          :: Maybe Text-    , _qIndexName                 :: Maybe Text-    , _qKeyConditionExpression    :: Maybe Text-    , _qKeyConditions             :: Map Text Condition-    , _qLimit                     :: Maybe Nat-    , _qProjectionExpression      :: Maybe Text-    , _qQueryFilter               :: Map Text Condition-    , _qReturnConsumedCapacity    :: Maybe ReturnConsumedCapacity-    , _qScanIndexForward          :: Maybe Bool-    , _qSelect                    :: Maybe Select-    , _qTableName                 :: Text-    } deriving (Eq, Read, Show)---- | 'Query' constructor.------ The fields accessible through corresponding lenses are:------ * 'qAttributesToGet' @::@ 'NonEmpty' 'Text'------ * 'qConditionalOperator' @::@ 'Maybe' 'ConditionalOperator'------ * 'qConsistentRead' @::@ 'Maybe' 'Bool'------ * 'qExclusiveStartKey' @::@ 'HashMap' 'Text' 'AttributeValue'------ * 'qExpressionAttributeNames' @::@ 'HashMap' 'Text' 'Text'------ * 'qExpressionAttributeValues' @::@ 'HashMap' 'Text' 'AttributeValue'------ * 'qFilterExpression' @::@ 'Maybe' 'Text'------ * 'qIndexName' @::@ 'Maybe' 'Text'------ * 'qKeyConditionExpression' @::@ 'Maybe' 'Text'------ * 'qKeyConditions' @::@ 'HashMap' 'Text' 'Condition'------ * 'qLimit' @::@ 'Maybe' 'Natural'------ * 'qProjectionExpression' @::@ 'Maybe' 'Text'------ * 'qQueryFilter' @::@ 'HashMap' 'Text' 'Condition'------ * 'qReturnConsumedCapacity' @::@ 'Maybe' 'ReturnConsumedCapacity'------ * 'qScanIndexForward' @::@ 'Maybe' 'Bool'------ * 'qSelect' @::@ 'Maybe' 'Select'------ * 'qTableName' @::@ 'Text'----query :: Text -- ^ 'qTableName'-      -> NonEmpty Text -- ^ 'qAttributesToGet'-      -> Query-query p1 p2 = Query-    { _qTableName                 = p1-    , _qAttributesToGet           = withIso _List1 (const id) p2-    , _qIndexName                 = Nothing-    , _qSelect                    = Nothing-    , _qLimit                     = Nothing-    , _qConsistentRead            = Nothing-    , _qKeyConditions             = mempty-    , _qQueryFilter               = mempty-    , _qConditionalOperator       = Nothing-    , _qScanIndexForward          = Nothing-    , _qExclusiveStartKey         = mempty-    , _qReturnConsumedCapacity    = Nothing-    , _qProjectionExpression      = Nothing-    , _qFilterExpression          = Nothing-    , _qKeyConditionExpression    = Nothing-    , _qExpressionAttributeNames  = mempty-    , _qExpressionAttributeValues = mempty-    }---- | This is a legacy parameter, for backward compatibility. New applications--- should use /ProjectionExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.------ This parameter allows you to retrieve attributes of type List or Map;--- however, it cannot retrieve individual elements within a List or a Map.------ The names of one or more attributes to retrieve. If no attribute names are--- provided, then all attributes will be returned. If any of the requested--- attributes are not found, they will not appear in the result.------ Note that /AttributesToGet/ has no effect on provisioned throughput--- consumption. DynamoDB determines capacity units consumed based on item size,--- not on the amount of data that is returned to an application.------ You cannot use both /AttributesToGet/ and /Select/ together in a /Query/ request, /unless/ the value for /Select/ is 'SPECIFIC_ATTRIBUTES'. (This usage is equivalent to--- specifying /AttributesToGet/ without any value for /Select/.)------ If you query a local secondary index and request only attributes that are--- projected into that index, the operation will read only the index and not the--- table. If any of the requested attributes are not projected into the local--- secondary index, DynamoDB will fetch each of these attributes from the parent--- table. This extra fetching incurs additional throughput cost and latency.------ If you query a global secondary index, you can only request attributes that--- are projected into the index. Global secondary index queries cannot fetch--- attributes from the parent table.-qAttributesToGet :: Lens' Query (NonEmpty Text)-qAttributesToGet = lens _qAttributesToGet (\s a -> s { _qAttributesToGet = a }) . _List1---- | This is a legacy parameter, for backward compatibility. New applications--- should use /FilterExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.------ A logical operator to apply to the conditions in a /QueryFilter/ map:------ 'AND' - If all of the conditions evaluate to true, then the entire map--- evaluates to true.------ 'OR' - If at least one of the conditions evaluate to true, then the entire map--- evaluates to true.------ If you omit /ConditionalOperator/, then 'AND' is the default.------ The operation will succeed only if the entire map evaluates to true.------ This parameter does not support attributes of type List or Map.----qConditionalOperator :: Lens' Query (Maybe ConditionalOperator)-qConditionalOperator =-    lens _qConditionalOperator (\s a -> s { _qConditionalOperator = a })---- | A value that if set to 'true', then the operation uses strongly consistent--- reads; otherwise, eventually consistent reads are used.------ Strongly consistent reads are not supported on global secondary indexes. If--- you query a global secondary index with /ConsistentRead/ set to 'true', you will--- receive an error message.-qConsistentRead :: Lens' Query (Maybe Bool)-qConsistentRead = lens _qConsistentRead (\s a -> s { _qConsistentRead = a })---- | The primary key of the first item that this operation will evaluate. Use the--- value that was returned for /LastEvaluatedKey/ in the previous operation.------ The data type for /ExclusiveStartKey/ must be String, Number or Binary. No set--- data types are allowed.-qExclusiveStartKey :: Lens' Query (HashMap Text AttributeValue)-qExclusiveStartKey =-    lens _qExclusiveStartKey (\s a -> s { _qExclusiveStartKey = a })-        . _Map---- | One or more substitution tokens for attribute names in an expression. The--- following are some use cases for using /ExpressionAttributeNames/:------ To access an attribute whose name conflicts with a DynamoDB reserved word.------ To create a placeholder for repeating occurrences of an attribute name in--- an expression.------ To prevent special characters in an attribute name from being--- misinterpreted in an expression.------ Use the # character in an expression to dereference an attribute name. For--- example, consider the following attribute name:------ 'Percentile'------ The name of this attribute conflicts with a reserved word, so it cannot be--- used directly in an expression. (For the complete list of reserved words, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words> in the /Amazon DynamoDB Developer Guide/). To work around this,--- you could specify the following for /ExpressionAttributeNames/:------ '{"#P":"Percentile"}'------ You could then use this substitution in an expression, as in this example:------ '#P = :val'------ Tokens that begin with the : character are /expression attribute values/,--- which are placeholders for the actual value at runtime.------ For more information on expression attribute names, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.-qExpressionAttributeNames :: Lens' Query (HashMap Text Text)-qExpressionAttributeNames =-    lens _qExpressionAttributeNames-        (\s a -> s { _qExpressionAttributeNames = a })-            . _Map---- | One or more values that can be substituted in an expression.------ Use the : (colon) character in an expression to dereference an attribute--- value. For example, suppose that you wanted to check whether the value of the /ProductStatus/ attribute was one of the following:------ 'Available | Backordered | Discontinued'------ You would first need to specify /ExpressionAttributeValues/ as follows:------ '{ ":avail":{"S":"Available"}, ":back":{"S":"Backordered"},":disc":{"S":"Discontinued"} }'------ You could then use these values in an expression, such as this:------ 'ProductStatus IN (:avail, :back, :disc)'------ For more information on expression attribute values, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionPlaceholders.html Using Placeholdersfor Attribute Names and Values> in the /Amazon DynamoDB Developer Guide/.-qExpressionAttributeValues :: Lens' Query (HashMap Text AttributeValue)-qExpressionAttributeValues =-    lens _qExpressionAttributeValues-        (\s a -> s { _qExpressionAttributeValues = a })-            . _Map---- | A string that contains conditions that DynamoDB applies after the /Query/--- operation, but before the data is returned to you. Items that do not satisfy--- the /FilterExpression/ criteria are not returned.------ A /FilterExpression/ is applied after the items have already been read; the--- process of filtering does not consume any additional read capacity units.------ For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults Filter Expressions> in the /Amazon DynamoDBDeveloper Guide/.------ /FilterExpression/ replaces the legacy /QueryFilter/ and /ConditionalOperator/--- parameters.----qFilterExpression :: Lens' Query (Maybe Text)-qFilterExpression =-    lens _qFilterExpression (\s a -> s { _qFilterExpression = a })---- | The name of an index to query. This index can be any local secondary index or--- global secondary index on the table. Note that if you use the /IndexName/--- parameter, you must also provide /TableName./-qIndexName :: Lens' Query (Maybe Text)-qIndexName = lens _qIndexName (\s a -> s { _qIndexName = a })---- | The condition that specifies the key value(s) for items to be retrieved by--- the /Query/ action.------ The condition must perform an equality test on a single hash key value. The--- condition can also test for one or more range key values. A /Query/ can use /KeyConditionExpression/ to retrieve a single item with a given hash and range key value, or several--- items that have the same hash key value but different range key values.------ The hash key equality test is required, and must be specified in the--- following format:------ 'hashAttributeName' /=/ ':hashval'------ If you also want to provide a range key condition, it must be combined using /AND/ with the hash key condition. Following is an example, using the =--- comparison operator for the range key:------ 'hashAttributeName' /=/ ':hashval' /AND/ 'rangeAttributeName' /=/ ':rangeval'------ Valid comparisons for the range key condition are as follows:------ 'rangeAttributeName' /=/ ':rangeval' - true if the range key is equal to ':rangeval'.------ 'rangeAttributeName' /</ ':rangeval' - true if the range key is less than ':rangeval'.------ 'rangeAttributeName' /<=/ ':rangeval' - true if the range key is less than or--- equal to ':rangeval'.------ 'rangeAttributeName' />/ ':rangeval' - true if the range key is greater than ':rangeval'.------ 'rangeAttributeName' />= /':rangeval' - true if the range key is greater than or--- equal to ':rangeval'.------ 'rangeAttributeName' /BETWEEN/ ':rangeval1' /AND/ ':rangeval2' - true if the range--- key is less than or greater than ':rangeval1', and less than or equal to ':rangeval2'.------ /begins_with (/'rangeAttributeName', ':rangeval'/)/ - true if the range key begins--- with a particular operand. Note that the function name 'begins_with' is--- case-sensitive.------ Use the /ExpressionAttributeValues/ parameter to replace tokens such as ':hashval' and ':rangeval' with actual values at runtime.------ You can optionally use the /ExpressionAttributeNames/ parameter to replace the--- names of the hash and range attributes with placeholder tokens. This might be--- necessary if an attribute name conflicts with a DynamoDB reserved word. For--- example, the following /KeyConditionExpression/ causes an error because /Size/ is--- a reserved word:------ 'Size = :myval'   To work around this, define a placeholder (such a '#myval')--- to represent the attribute name /Size/. /KeyConditionExpression/ then is as--- follows:------ '#S = :myval'   For a list of reserved words, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words> in the /Amazon DynamoDB Developer Guide/.------ For more information on /ExpressionAttributeNames/ and /ExpressionAttributeValues/, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html Using Placeholders for Attribute Names and Values> in the /AmazonDynamoDB Developer Guide/.------ /KeyConditionExpression/ replaces the legacy /KeyConditions/ parameter.-------qKeyConditionExpression :: Lens' Query (Maybe Text)-qKeyConditionExpression =-    lens _qKeyConditionExpression (\s a -> s { _qKeyConditionExpression = a })---- | This is a legacy parameter, for backward compatibility. New applications--- should use /KeyConditionExpression/ instead. Do not combine legacy parameters--- and expression parameters in a single API call; otherwise, DynamoDB will--- return a /ValidationException/ exception.------ The selection criteria for the query. For a query on a table, you can have--- conditions only on the table primary key attributes. You must provide the--- hash key attribute name and value as an 'EQ' condition. You can optionally--- provide a second condition, referring to the range key attribute.------ If you don't provide a range key condition, all of the items that match the--- hash key will be retrieved. If a /FilterExpression/ or /QueryFilter/ is present,--- it will be applied after the items are retrieved.------ For a query on an index, you can have conditions only on the index key--- attributes. You must provide the index hash attribute name and value as an 'EQ'--- condition. You can optionally provide a second condition, referring to the--- index key range attribute.------ Each /KeyConditions/ element consists of an attribute name to compare, along--- with the following:------ /AttributeValueList/ - One or more values to evaluate against the supplied--- attribute. The number of values in the list depends on the /ComparisonOperator/--- being used.------ For type Number, value comparisons are numeric.------ String value comparisons for greater than, equals, or less than are based on--- ASCII character code values. For example, 'a' is greater than 'A', and 'a' is--- greater than 'B'. For a list of code values, see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>.------ For Binary, DynamoDB treats each byte of the binary data as unsigned when it--- compares binary values.------ /ComparisonOperator/ - A comparator for evaluating attributes, for example,--- equals, greater than, less than, and so on.------ For /KeyConditions/, only the following comparison operators are supported:------ 'EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN'------ The following are descriptions of these comparison operators.------ 'EQ' : Equal.------ /AttributeValueList/ can contain only one /AttributeValue/ of type String,--- Number, or Binary (not a set type). If an item contains an /AttributeValue/--- element of a different type than the one specified in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not equal '{"NS":["6", "2", "1"]}'.------------ 'LE' : Less than or equal.------ /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.------------ 'LT' : Less than.------ /AttributeValueList/ can contain only one /AttributeValue/ of type String,--- Number, or Binary (not a set type). If an item contains an /AttributeValue/--- element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.------------ 'GE' : Greater than or equal.------ /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.------------ 'GT' : Greater than.------ /AttributeValueList/ can contain only one /AttributeValue/ element of type--- String, Number, or Binary (not a set type). If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not equal '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'.------------ 'BEGINS_WITH' : Checks for a prefix.------ /AttributeValueList/ can contain only one /AttributeValue/ of type String or--- Binary (not a Number or a set type). The target attribute of the comparison--- must be of type String or Binary (not a Number or a set type).------------ 'BETWEEN' : Greater than or equal to the first value, and less than or equal--- to the second value.------ /AttributeValueList/ must contain two /AttributeValue/ elements of the same--- type, either String, Number, or Binary (not a set type). A target attribute--- matches if the target value is greater than, or equal to, the first element--- and less than, or equal to, the second element. If an item contains an /AttributeValue/ element of a different type than the one provided in the request, the value--- does not match. For example, '{"S":"6"}' does not compare to '{"N":"6"}'. Also, '{"N":"6"}' does not compare to '{"NS":["6", "2", "1"]}'------ For usage examples of /AttributeValueList/ and /ComparisonOperator/, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html Legacy Conditional Parameters> in the /Amazon DynamoDB Developer Guide/.-qKeyConditions :: Lens' Query (HashMap Text Condition)-qKeyConditions = lens _qKeyConditions (\s a -> s { _qKeyConditions = a }) . _Map---- | The maximum number of items to evaluate (not necessarily the number of--- matching items). If DynamoDB processes the number of items up to the limit--- while processing the results, it stops the operation and returns the matching--- values up to that point, and a key in /LastEvaluatedKey/ to apply in a--- subsequent operation, so that you can pick up where you left off. Also, if--- the processed data set size exceeds 1 MB before DynamoDB reaches this limit,--- it stops the operation and returns the matching values up to the limit, and a--- key in /LastEvaluatedKey/ to apply in a subsequent operation to continue the--- operation. For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan> in the /Amazon DynamoDBDeveloper Guide/.-qLimit :: Lens' Query (Maybe Natural)-qLimit = lens _qLimit (\s a -> s { _qLimit = a }) . mapping _Nat---- | A string that identifies one or more attributes to retrieve from the table.--- These attributes can include scalars, sets, or elements of a JSON document.--- The attributes in the expression must be separated by commas.------ If no attribute names are specified, then all attributes will be returned.--- If any of the requested attributes are not found, they will not appear in the--- result.------ For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes> in the /Amazon DynamoDBDeveloper Guide/.------ /ProjectionExpression/ replaces the legacy /AttributesToGet/ parameter.----qProjectionExpression :: Lens' Query (Maybe Text)-qProjectionExpression =-    lens _qProjectionExpression (\s a -> s { _qProjectionExpression = a })---- | This is a legacy parameter, for backward compatibility. New applications--- should use /FilterExpression/ instead. Do not combine legacy parameters and--- expression parameters in a single API call; otherwise, DynamoDB will return a /ValidationException/ exception.------ A condition that evaluates the query results after the items are read and--- returns only the desired values.------ This parameter does not support attributes of type List or Map.------ A /QueryFilter/ is applied after the items have already been read; the--- process of filtering does not consume any additional read capacity units.------ If you provide more than one condition in the /QueryFilter/ map, then by--- default all of the conditions must evaluate to true. In other words, the--- conditions are ANDed together. (You can use the /ConditionalOperator/ parameter--- to OR the conditions instead. If you do this, then at least one of the--- conditions must evaluate to true, rather than all of them.)------ Note that /QueryFilter/ does not allow key attributes. You cannot define a--- filter condition on a hash key or range key.------ Each /QueryFilter/ element consists of an attribute name to compare, along--- with the following:------ /AttributeValueList/ - One or more values to evaluate against the supplied--- attribute. The number of values in the list depends on the operator specified--- in /ComparisonOperator/.------ For type Number, value comparisons are numeric.------ String value comparisons for greater than, equals, or less than are based on--- ASCII character code values. For example, 'a' is greater than 'A', and 'a' is--- greater than 'B'. For a list of code values, see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>.------ For type Binary, DynamoDB treats each byte of the binary data as unsigned--- when it compares binary values.------ For information on specifying data types in JSON, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataFormat.html JSON Data Format> in--- the /Amazon DynamoDB Developer Guide/.------ /ComparisonOperator/ - A comparator for evaluating attributes. For example,--- equals, greater than, less than, etc.------ The following comparison operators are available:------ 'EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS |BEGINS_WITH | IN | BETWEEN'------ For complete descriptions of all comparison operators, see the <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Condition.html Condition>--- data type.-------qQueryFilter :: Lens' Query (HashMap Text Condition)-qQueryFilter = lens _qQueryFilter (\s a -> s { _qQueryFilter = a }) . _Map--qReturnConsumedCapacity :: Lens' Query (Maybe ReturnConsumedCapacity)-qReturnConsumedCapacity =-    lens _qReturnConsumedCapacity (\s a -> s { _qReturnConsumedCapacity = a })---- | A value that specifies ascending (true) or descending (false) traversal of--- the index. DynamoDB returns results reflecting the requested order determined--- by the range key. If the data type is Number, the results are returned in--- numeric order. For type String, the results are returned in order of ASCII--- character code values. For type Binary, DynamoDB treats each byte of the--- binary data as unsigned when it compares binary values.------ If /ScanIndexForward/ is not specified, the results are returned in ascending--- order.-qScanIndexForward :: Lens' Query (Maybe Bool)-qScanIndexForward =-    lens _qScanIndexForward (\s a -> s { _qScanIndexForward = a })---- | The attributes to be returned in the result. You can retrieve all item--- attributes, specific item attributes, the count of matching items, or in the--- case of an index, some or all of the attributes projected into the index.------ 'ALL_ATTRIBUTES' - Returns all of the item attributes from the specified--- table or index. If you query a local secondary index, then for each matching--- item in the index DynamoDB will fetch the entire item from the parent table.--- If the index is configured to project all item attributes, then all of the--- data can be obtained from the local secondary index, and no fetching is--- required.------ 'ALL_PROJECTED_ATTRIBUTES' - Allowed only when querying an index. Retrieves--- all attributes that have been projected into the index. If the index is--- configured to project all attributes, this return value is equivalent to--- specifying 'ALL_ATTRIBUTES'.------ 'COUNT' - Returns the number of matching items, rather than the matching--- items themselves.------ 'SPECIFIC_ATTRIBUTES' - Returns only the attributes listed in /AttributesToGet/. This return value is equivalent to specifying /AttributesToGet/ without--- specifying any value for /Select/.------ If you query a local secondary index and request only attributes that are--- projected into that index, the operation will read only the index and not the--- table. If any of the requested attributes are not projected into the local--- secondary index, DynamoDB will fetch each of these attributes from the parent--- table. This extra fetching incurs additional throughput cost and latency.------ If you query a global secondary index, you can only request attributes that--- are projected into the index. Global secondary index queries cannot fetch--- attributes from the parent table.------ If neither /Select/ nor /AttributesToGet/ are specified, DynamoDB defaults to 'ALL_ATTRIBUTES' when accessing a table, and 'ALL_PROJECTED_ATTRIBUTES' when accessing an--- index. You cannot use both /Select/ and /AttributesToGet/ together in a single--- request, unless the value for /Select/ is 'SPECIFIC_ATTRIBUTES'. (This usage is--- equivalent to specifying /AttributesToGet/ without any value for /Select/.)------ If you use the /ProjectionExpression/ parameter, then the value for /Select/ can--- only be 'SPECIFIC_ATTRIBUTES'. Any other value for /Select/ will return an error.----qSelect :: Lens' Query (Maybe Select)-qSelect = lens _qSelect (\s a -> s { _qSelect = a })---- | The name of the table containing the requested items.-qTableName :: Lens' Query Text-qTableName = lens _qTableName (\s a -> s { _qTableName = a })--data QueryResponse = QueryResponse-    { _qrConsumedCapacity :: Maybe ConsumedCapacity-    , _qrCount            :: Maybe Int-    , _qrItems            :: List "Items" (Map Text AttributeValue)-    , _qrLastEvaluatedKey :: Map Text AttributeValue-    , _qrScannedCount     :: Maybe Int-    } deriving (Eq, Read, Show)---- | 'QueryResponse' constructor.------ The fields accessible through corresponding lenses are:------ * 'qrConsumedCapacity' @::@ 'Maybe' 'ConsumedCapacity'------ * 'qrCount' @::@ 'Maybe' 'Int'------ * 'qrItems' @::@ ['HashMap' 'Text' 'AttributeValue']------ * 'qrLastEvaluatedKey' @::@ 'HashMap' 'Text' 'AttributeValue'------ * 'qrScannedCount' @::@ 'Maybe' 'Int'----queryResponse :: QueryResponse-queryResponse = QueryResponse-    { _qrItems            = mempty-    , _qrCount            = Nothing-    , _qrScannedCount     = Nothing-    , _qrLastEvaluatedKey = mempty-    , _qrConsumedCapacity = Nothing-    }--qrConsumedCapacity :: Lens' QueryResponse (Maybe ConsumedCapacity)-qrConsumedCapacity =-    lens _qrConsumedCapacity (\s a -> s { _qrConsumedCapacity = a })---- | The number of items in the response.------ If you used a /QueryFilter/ in the request, then /Count/ is the number of items--- returned after the filter was applied, and /ScannedCount/ is the number of--- matching items before> the filter was applied.------ If you did not use a filter in the request, then /Count/ and /ScannedCount/ are--- the same.-qrCount :: Lens' QueryResponse (Maybe Int)-qrCount = lens _qrCount (\s a -> s { _qrCount = a })---- | An array of item attributes that match the query criteria. Each element in--- this array consists of an attribute name and the value for that attribute.-qrItems :: Lens' QueryResponse [HashMap Text AttributeValue]-qrItems = lens _qrItems (\s a -> s { _qrItems = a }) . _List---- | The primary key of the item where the operation stopped, inclusive of the--- previous result set. Use this value to start a new operation, excluding this--- value in the new request.------ If /LastEvaluatedKey/ is empty, then the "last page" of results has been--- processed and there is no more data to be retrieved.------ If /LastEvaluatedKey/ is not empty, it does not necessarily mean that there is--- more data in the result set. The only way to know when you have reached the--- end of the result set is when /LastEvaluatedKey/ is empty.-qrLastEvaluatedKey :: Lens' QueryResponse (HashMap Text AttributeValue)-qrLastEvaluatedKey =-    lens _qrLastEvaluatedKey (\s a -> s { _qrLastEvaluatedKey = a })-        . _Map---- | The number of items evaluated, before any /QueryFilter/ is applied. A high /ScannedCount/ value with few, or no, /Count/ results indicates an inefficient /Query/--- operation. For more information, see <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Count Count and ScannedCount> in the /AmazonDynamoDB Developer Guide/.------ If you did not use a filter in the request, then /ScannedCount/ is the same as /Count/.-qrScannedCount :: Lens' QueryResponse (Maybe Int)-qrScannedCount = lens _qrScannedCount (\s a -> s { _qrScannedCount = a })--instance ToPath Query where-    toPath = const "/"--instance ToQuery Query where-    toQuery = const mempty--instance ToHeaders Query--instance ToJSON Query where-    toJSON Query{..} = object-        [ "TableName"                 .= _qTableName-        , "IndexName"                 .= _qIndexName-        , "Select"                    .= _qSelect-        , "AttributesToGet"           .= _qAttributesToGet-        , "Limit"                     .= _qLimit-        , "ConsistentRead"            .= _qConsistentRead-        , "KeyConditions"             .= _qKeyConditions-        , "QueryFilter"               .= _qQueryFilter-        , "ConditionalOperator"       .= _qConditionalOperator-        , "ScanIndexForward"          .= _qScanIndexForward-        , "ExclusiveStartKey"         .= _qExclusiveStartKey-        , "ReturnConsumedCapacity"    .= _qReturnConsumedCapacity-        , "ProjectionExpression"      .= _qProjectionExpression-        , "FilterExpression"          .= _qFilterExpression-        , "KeyConditionExpression"    .= _qKeyConditionExpression-        , "ExpressionAttributeNames"  .= _qExpressionAttributeNames-        , "ExpressionAttributeValues" .= _qExpressionAttributeValues-        ]--instance AWSRequest Query where-    type Sv Query = DynamoDB-    type Rs Query = QueryResponse--    request  = post "Query"-    response = jsonResponse--instance FromJSON QueryResponse where-    parseJSON = withObject "QueryResponse" $ \o -> QueryResponse-        <$> o .:? "ConsumedCapacity"-        <*> o .:? "Count"-        <*> o .:? "Items" .!= mempty-        <*> o .:? "LastEvaluatedKey" .!= mempty-        <*> o .:? "ScannedCount"--instance AWSPager Query where-    page rq rs-        | stop (rs ^. qrLastEvaluatedKey) = Nothing-        | otherwise = Just $ rq-            & qExclusiveStartKey .~ rs ^. qrLastEvaluatedKey+{-# LANGUAGE DeriveDataTypeable #-}+{-# LANGUAGE DeriveGeneric      #-}+{-# LANGUAGE OverloadedStrings  #-}+{-# LANGUAGE RecordWildCards    #-}+{-# LANGUAGE TypeFamilies       #-}++{-# OPTIONS_GHC -fno-warn-unused-imports #-}+{-# OPTIONS_GHC -fno-warn-unused-binds   #-}+{-# OPTIONS_GHC -fno-warn-unused-matches #-}++-- Derived from AWS service descriptions, licensed under Apache 2.0.++-- |+-- Module      : Network.AWS.DynamoDB.Query+-- Copyright   : (c) 2013-2015 Brendan Hay+-- License     : Mozilla Public License, v. 2.0.+-- Maintainer  : Brendan Hay <brendan.g.hay@gmail.com>+-- Stability   : auto-generated+-- Portability : non-portable (GHC extensions)+--+-- A /Query/ operation uses the primary key of a table or a secondary index+-- to directly access items from that table or index.+--+-- Use the /KeyConditionExpression/ parameter to provide a specific hash+-- key value. The /Query/ operation will return all of the items from the+-- table or index with that hash key value. You can optionally narrow the+-- scope of the /Query/ operation by specifying a range key value and a+-- comparison operator in /KeyConditionExpression/. You can use the+-- /ScanIndexForward/ parameter to get results in forward or reverse order,+-- by range key or by index key.+--+-- Queries that do not return results consume the minimum number of read+-- capacity units for that type of read operation.+--+-- If the total number of items meeting the query criteria exceeds the+-- result set size limit of 1 MB, the query stops and results are returned+-- to the user with the /LastEvaluatedKey/ element to continue the query in+-- a subsequent operation. Unlike a /Scan/ operation, a /Query/ operation+-- never returns both an empty result set and a /LastEvaluatedKey/ value.+-- /LastEvaluatedKey/ is only provided if the results exceed 1 MB, or if+-- you have used the /Limit/ parameter.+--+-- You can query a table, a local secondary index, or a global secondary+-- index. For a query on a table or on a local secondary index, you can set+-- the /ConsistentRead/ parameter to 'true' and obtain a strongly+-- consistent result. Global secondary indexes support eventually+-- consistent reads only, so do not specify /ConsistentRead/ when querying+-- a global secondary index.+--+-- /See:/ <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html AWS API Reference> for Query.+--+-- This operation returns paginated results.+module Network.AWS.DynamoDB.Query+    (+    -- * Creating a Request+      query+    , Query+    -- * Request Lenses+    , qProjectionExpression+    , qKeyConditions+    , qFilterExpression+    , qQueryFilter+    , qConsistentRead+    , qExpressionAttributeNames+    , qAttributesToGet+    , qReturnConsumedCapacity+    , qExpressionAttributeValues+    , qScanIndexForward+    , qLimit+    , qSelect+    , qConditionalOperator+    , qKeyConditionExpression+    , qExclusiveStartKey+    , qIndexName+    , qTableName++    -- * Destructuring the Response+    , queryResponse+    , QueryResponse+    -- * Response Lenses+    , qrsLastEvaluatedKey+    , qrsCount+    , qrsScannedCount+    , qrsItems+    , qrsConsumedCapacity+    , qrsStatus+    ) where++import           Network.AWS.DynamoDB.Types+import           Network.AWS.DynamoDB.Types.Product+import           Network.AWS.Pager+import           Network.AWS.Prelude+import           Network.AWS.Request+import           Network.AWS.Response++-- | Represents the input of a /Query/ operation.+--+-- /See:/ 'query' smart constructor.+data Query = Query'+    { _qProjectionExpression      :: !(Maybe Text)+    , _qKeyConditions             :: !(Maybe (Map Text Condition))+    , _qFilterExpression          :: !(Maybe Text)+    , _qQueryFilter               :: !(Maybe (Map Text Condition))+    , _qConsistentRead            :: !(Maybe Bool)+    , _qExpressionAttributeNames  :: !(Maybe (Map Text Text))+    , _qAttributesToGet           :: !(Maybe (List1 Text))+    , _qReturnConsumedCapacity    :: !(Maybe ReturnConsumedCapacity)+    , _qExpressionAttributeValues :: !(Maybe (Map Text AttributeValue))+    , _qScanIndexForward          :: !(Maybe Bool)+    , _qLimit                     :: !(Maybe Nat)+    , _qSelect                    :: !(Maybe Select)+    , _qConditionalOperator       :: !(Maybe ConditionalOperator)+    , _qKeyConditionExpression    :: !(Maybe Text)+    , _qExclusiveStartKey         :: !(Maybe (Map Text AttributeValue))+    , _qIndexName                 :: !(Maybe Text)+    , _qTableName                 :: !Text+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'Query' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'qProjectionExpression'+--+-- * 'qKeyConditions'+--+-- * 'qFilterExpression'+--+-- * 'qQueryFilter'+--+-- * 'qConsistentRead'+--+-- * 'qExpressionAttributeNames'+--+-- * 'qAttributesToGet'+--+-- * 'qReturnConsumedCapacity'+--+-- * 'qExpressionAttributeValues'+--+-- * 'qScanIndexForward'+--+-- * 'qLimit'+--+-- * 'qSelect'+--+-- * 'qConditionalOperator'+--+-- * 'qKeyConditionExpression'+--+-- * 'qExclusiveStartKey'+--+-- * 'qIndexName'+--+-- * 'qTableName'+query+    :: Text -- ^ 'qTableName'+    -> Query+query pTableName_ =+    Query'+    { _qProjectionExpression = Nothing+    , _qKeyConditions = Nothing+    , _qFilterExpression = Nothing+    , _qQueryFilter = Nothing+    , _qConsistentRead = Nothing+    , _qExpressionAttributeNames = Nothing+    , _qAttributesToGet = Nothing+    , _qReturnConsumedCapacity = Nothing+    , _qExpressionAttributeValues = Nothing+    , _qScanIndexForward = Nothing+    , _qLimit = Nothing+    , _qSelect = Nothing+    , _qConditionalOperator = Nothing+    , _qKeyConditionExpression = Nothing+    , _qExclusiveStartKey = Nothing+    , _qIndexName = Nothing+    , _qTableName = pTableName_+    }++-- | A string that identifies one or more attributes to retrieve from the+-- table. These attributes can include scalars, sets, or elements of a JSON+-- document. The attributes in the expression must be separated by commas.+--+-- If no attribute names are specified, then all attributes will be+-- returned. If any of the requested attributes are not found, they will+-- not appear in the result.+--+-- For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- /ProjectionExpression/ replaces the legacy /AttributesToGet/ parameter.+qProjectionExpression :: Lens' Query (Maybe Text)+qProjectionExpression = lens _qProjectionExpression (\ s a -> s{_qProjectionExpression = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /KeyConditionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception.+--+-- The selection criteria for the query. For a query on a table, you can+-- have conditions only on the table primary key attributes. You must+-- provide the hash key attribute name and value as an 'EQ' condition. You+-- can optionally provide a second condition, referring to the range key+-- attribute.+--+-- If you don\'t provide a range key condition, all of the items that match+-- the hash key will be retrieved. If a /FilterExpression/ or /QueryFilter/+-- is present, it will be applied after the items are retrieved.+--+-- For a query on an index, you can have conditions only on the index key+-- attributes. You must provide the index hash attribute name and value as+-- an 'EQ' condition. You can optionally provide a second condition,+-- referring to the index key range attribute.+--+-- Each /KeyConditions/ element consists of an attribute name to compare,+-- along with the following:+--+-- -   /AttributeValueList/ - One or more values to evaluate against the+--     supplied attribute. The number of values in the list depends on the+--     /ComparisonOperator/ being used.+--+--     For type Number, value comparisons are numeric.+--+--     String value comparisons for greater than, equals, or less than are+--     based on ASCII character code values. For example, 'a' is greater+--     than 'A', and 'a' is greater than 'B'. For a list of code values,+--     see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>.+--+--     For Binary, DynamoDB treats each byte of the binary data as unsigned+--     when it compares binary values.+--+-- -   /ComparisonOperator/ - A comparator for evaluating attributes, for+--     example, equals, greater than, less than, and so on.+--+--     For /KeyConditions/, only the following comparison operators are+--     supported:+--+--     'EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN'+--+--     The following are descriptions of these comparison operators.+--+--     -   'EQ' : Equal.+--+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String, Number, or Binary (not a set type). If an item+--         contains an /AttributeValue/ element of a different type than+--         the one specified in the request, the value does not match. For+--         example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'. Also,+--         '{\"N\":\"6\"}' does not equal '{\"NS\":[\"6\", \"2\", \"1\"]}'.+--+--     -   'LE' : Less than or equal.+--+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'.+--+--     -   'LT' : Less than.+--+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String, Number, or Binary (not a set type). If an item+--         contains an /AttributeValue/ element of a different type than+--         the one provided in the request, the value does not match. For+--         example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'. Also,+--         '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'.+--+--     -   'GE' : Greater than or equal.+--+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'.+--+--     -   'GT' : Greater than.+--+--         /AttributeValueList/ can contain only one /AttributeValue/+--         element of type String, Number, or Binary (not a set type). If+--         an item contains an /AttributeValue/ element of a different type+--         than the one provided in the request, the value does not match.+--         For example, '{\"S\":\"6\"}' does not equal '{\"N\":\"6\"}'.+--         Also, '{\"N\":\"6\"}' does not compare to+--         '{\"NS\":[\"6\", \"2\", \"1\"]}'.+--+--     -   'BEGINS_WITH' : Checks for a prefix.+--+--         /AttributeValueList/ can contain only one /AttributeValue/ of+--         type String or Binary (not a Number or a set type). The target+--         attribute of the comparison must be of type String or Binary+--         (not a Number or a set type).+--+--     -   'BETWEEN' : Greater than or equal to the first value, and less+--         than or equal to the second value.+--+--         /AttributeValueList/ must contain two /AttributeValue/ elements+--         of the same type, either String, Number, or Binary (not a set+--         type). A target attribute matches if the target value is greater+--         than, or equal to, the first element and less than, or equal to,+--         the second element. If an item contains an /AttributeValue/+--         element of a different type than the one provided in the+--         request, the value does not match. For example, '{\"S\":\"6\"}'+--         does not compare to '{\"N\":\"6\"}'. Also, '{\"N\":\"6\"}' does+--         not compare to '{\"NS\":[\"6\", \"2\", \"1\"]}'+--+-- For usage examples of /AttributeValueList/ and /ComparisonOperator/, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.html Legacy Conditional Parameters>+-- in the /Amazon DynamoDB Developer Guide/.+qKeyConditions :: Lens' Query (HashMap Text Condition)+qKeyConditions = lens _qKeyConditions (\ s a -> s{_qKeyConditions = a}) . _Default . _Map;++-- | A string that contains conditions that DynamoDB applies after the+-- /Query/ operation, but before the data is returned to you. Items that do+-- not satisfy the /FilterExpression/ criteria are not returned.+--+-- A /FilterExpression/ is applied after the items have already been read;+-- the process of filtering does not consume any additional read capacity+-- units.+--+-- For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults Filter Expressions>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- /FilterExpression/ replaces the legacy /QueryFilter/ and+-- /ConditionalOperator/ parameters.+qFilterExpression :: Lens' Query (Maybe Text)+qFilterExpression = lens _qFilterExpression (\ s a -> s{_qFilterExpression = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /FilterExpression/ instead. Do not combine legacy parameters+-- and expression parameters in a single API call; otherwise, DynamoDB will+-- return a /ValidationException/ exception.+--+-- A condition that evaluates the query results after the items are read+-- and returns only the desired values.+--+-- This parameter does not support attributes of type List or Map.+--+-- A /QueryFilter/ is applied after the items have already been read; the+-- process of filtering does not consume any additional read capacity+-- units.+--+-- If you provide more than one condition in the /QueryFilter/ map, then by+-- default all of the conditions must evaluate to true. In other words, the+-- conditions are ANDed together. (You can use the /ConditionalOperator/+-- parameter to OR the conditions instead. If you do this, then at least+-- one of the conditions must evaluate to true, rather than all of them.)+--+-- Note that /QueryFilter/ does not allow key attributes. You cannot define+-- a filter condition on a hash key or range key.+--+-- Each /QueryFilter/ element consists of an attribute name to compare,+-- along with the following:+--+-- -   /AttributeValueList/ - One or more values to evaluate against the+--     supplied attribute. The number of values in the list depends on the+--     operator specified in /ComparisonOperator/.+--+--     For type Number, value comparisons are numeric.+--+--     String value comparisons for greater than, equals, or less than are+--     based on ASCII character code values. For example, 'a' is greater+--     than 'A', and 'a' is greater than 'B'. For a list of code values,+--     see <http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters>.+--+--     For type Binary, DynamoDB treats each byte of the binary data as+--     unsigned when it compares binary values.+--+--     For information on specifying data types in JSON, see+--     <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataFormat.html JSON Data Format>+--     in the /Amazon DynamoDB Developer Guide/.+--+-- -   /ComparisonOperator/ - A comparator for evaluating attributes. For+--     example, equals, greater than, less than, etc.+--+--     The following comparison operators are available:+--+--     'EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN'+--+--     For complete descriptions of all comparison operators, see the+--     <http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Condition.html Condition>+--     data type.+--+qQueryFilter :: Lens' Query (HashMap Text Condition)+qQueryFilter = lens _qQueryFilter (\ s a -> s{_qQueryFilter = a}) . _Default . _Map;++-- | Determines the read consistency model: If set to 'true', then the+-- operation uses strongly consistent reads; otherwise, the operation uses+-- eventually consistent reads.+--+-- Strongly consistent reads are not supported on global secondary indexes.+-- If you query a global secondary index with /ConsistentRead/ set to+-- 'true', you will receive a /ValidationException/.+qConsistentRead :: Lens' Query (Maybe Bool)+qConsistentRead = lens _qConsistentRead (\ s a -> s{_qConsistentRead = a});++-- | One or more substitution tokens for attribute names in an expression.+-- The following are some use cases for using /ExpressionAttributeNames/:+--+-- -   To access an attribute whose name conflicts with a DynamoDB reserved+--     word.+--+-- -   To create a placeholder for repeating occurrences of an attribute+--     name in an expression.+--+-- -   To prevent special characters in an attribute name from being+--     misinterpreted in an expression.+--+-- Use the __#__ character in an expression to dereference an attribute+-- name. For example, consider the following attribute name:+--+-- -   'Percentile'+--+-- The name of this attribute conflicts with a reserved word, so it cannot+-- be used directly in an expression. (For the complete list of reserved+-- words, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words>+-- in the /Amazon DynamoDB Developer Guide/). To work around this, you+-- could specify the following for /ExpressionAttributeNames/:+--+-- -   '{\"#P\":\"Percentile\"}'+--+-- You could then use this substitution in an expression, as in this+-- example:+--+-- -   '#P = :val'+--+-- Tokens that begin with the __:__ character are /expression attribute+-- values/, which are placeholders for the actual value at runtime.+--+-- For more information on expression attribute names, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html Accessing Item Attributes>+-- in the /Amazon DynamoDB Developer Guide/.+qExpressionAttributeNames :: Lens' Query (HashMap Text Text)+qExpressionAttributeNames = lens _qExpressionAttributeNames (\ s a -> s{_qExpressionAttributeNames = a}) . _Default . _Map;++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /ProjectionExpression/ instead. Do not combine legacy+-- parameters and expression parameters in a single API call; otherwise,+-- DynamoDB will return a /ValidationException/ exception.+--+-- This parameter allows you to retrieve attributes of type List or Map;+-- however, it cannot retrieve individual elements within a List or a Map.+--+-- The names of one or more attributes to retrieve. If no attribute names+-- are provided, then all attributes will be returned. If any of the+-- requested attributes are not found, they will not appear in the result.+--+-- Note that /AttributesToGet/ has no effect on provisioned throughput+-- consumption. DynamoDB determines capacity units consumed based on item+-- size, not on the amount of data that is returned to an application.+--+-- You cannot use both /AttributesToGet/ and /Select/ together in a /Query/+-- request, /unless/ the value for /Select/ is 'SPECIFIC_ATTRIBUTES'. (This+-- usage is equivalent to specifying /AttributesToGet/ without any value+-- for /Select/.)+--+-- If you query a local secondary index and request only attributes that+-- are projected into that index, the operation will read only the index+-- and not the table. If any of the requested attributes are not projected+-- into the local secondary index, DynamoDB will fetch each of these+-- attributes from the parent table. This extra fetching incurs additional+-- throughput cost and latency.+--+-- If you query a global secondary index, you can only request attributes+-- that are projected into the index. Global secondary index queries cannot+-- fetch attributes from the parent table.+qAttributesToGet :: Lens' Query (Maybe (NonEmpty Text))+qAttributesToGet = lens _qAttributesToGet (\ s a -> s{_qAttributesToGet = a}) . mapping _List1;++-- | Undocumented member.+qReturnConsumedCapacity :: Lens' Query (Maybe ReturnConsumedCapacity)+qReturnConsumedCapacity = lens _qReturnConsumedCapacity (\ s a -> s{_qReturnConsumedCapacity = a});++-- | One or more values that can be substituted in an expression.+--+-- Use the __:__ (colon) character in an expression to dereference an+-- attribute value. For example, suppose that you wanted to check whether+-- the value of the /ProductStatus/ attribute was one of the following:+--+-- 'Available | Backordered | Discontinued'+--+-- You would first need to specify /ExpressionAttributeValues/ as follows:+--+-- '{ \":avail\":{\"S\":\"Available\"}, \":back\":{\"S\":\"Backordered\"}, \":disc\":{\"S\":\"Discontinued\"} }'+--+-- You could then use these values in an expression, such as this:+--+-- 'ProductStatus IN (:avail, :back, :disc)'+--+-- For more information on expression attribute values, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html Specifying Conditions>+-- in the /Amazon DynamoDB Developer Guide/.+qExpressionAttributeValues :: Lens' Query (HashMap Text AttributeValue)+qExpressionAttributeValues = lens _qExpressionAttributeValues (\ s a -> s{_qExpressionAttributeValues = a}) . _Default . _Map;++-- | Specifies the order in which to return the query results - either+-- ascending ('true') or descending ('false').+--+-- Items with the same hash key are stored in sorted order by range key .If+-- the range key data type is Number, the results are stored in numeric+-- order. For type String, the results are returned in order of ASCII+-- character code values. For type Binary, DynamoDB treats each byte of the+-- binary data as unsigned.+--+-- If /ScanIndexForward/ is 'true', DynamoDB returns the results in order,+-- by range key. This is the default behavior.+--+-- If /ScanIndexForward/ is 'false', DynamoDB sorts the results in+-- descending order by range key, and then returns the results to the+-- client.+qScanIndexForward :: Lens' Query (Maybe Bool)+qScanIndexForward = lens _qScanIndexForward (\ s a -> s{_qScanIndexForward = a});++-- | The maximum number of items to evaluate (not necessarily the number of+-- matching items). If DynamoDB processes the number of items up to the+-- limit while processing the results, it stops the operation and returns+-- the matching values up to that point, and a key in /LastEvaluatedKey/ to+-- apply in a subsequent operation, so that you can pick up where you left+-- off. Also, if the processed data set size exceeds 1 MB before DynamoDB+-- reaches this limit, it stops the operation and returns the matching+-- values up to the limit, and a key in /LastEvaluatedKey/ to apply in a+-- subsequent operation to continue the operation. For more information,+-- see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html Query and Scan>+-- in the /Amazon DynamoDB Developer Guide/.+qLimit :: Lens' Query (Maybe Natural)+qLimit = lens _qLimit (\ s a -> s{_qLimit = a}) . mapping _Nat;++-- | The attributes to be returned in the result. You can retrieve all item+-- attributes, specific item attributes, the count of matching items, or in+-- the case of an index, some or all of the attributes projected into the+-- index.+--+-- -   'ALL_ATTRIBUTES' - Returns all of the item attributes from the+--     specified table or index. If you query a local secondary index, then+--     for each matching item in the index DynamoDB will fetch the entire+--     item from the parent table. If the index is configured to project+--     all item attributes, then all of the data can be obtained from the+--     local secondary index, and no fetching is required.+--+-- -   'ALL_PROJECTED_ATTRIBUTES' - Allowed only when querying an index.+--     Retrieves all attributes that have been projected into the index. If+--     the index is configured to project all attributes, this return value+--     is equivalent to specifying 'ALL_ATTRIBUTES'.+--+-- -   'COUNT' - Returns the number of matching items, rather than the+--     matching items themselves.+--+-- -   'SPECIFIC_ATTRIBUTES' - Returns only the attributes listed in+--     /AttributesToGet/. This return value is equivalent to specifying+--     /AttributesToGet/ without specifying any value for /Select/.+--+--     If you query a local secondary index and request only attributes+--     that are projected into that index, the operation will read only the+--     index and not the table. If any of the requested attributes are not+--     projected into the local secondary index, DynamoDB will fetch each+--     of these attributes from the parent table. This extra fetching+--     incurs additional throughput cost and latency.+--+--     If you query a global secondary index, you can only request+--     attributes that are projected into the index. Global secondary index+--     queries cannot fetch attributes from the parent table.+--+-- If neither /Select/ nor /AttributesToGet/ are specified, DynamoDB+-- defaults to 'ALL_ATTRIBUTES' when accessing a table, and+-- 'ALL_PROJECTED_ATTRIBUTES' when accessing an index. You cannot use both+-- /Select/ and /AttributesToGet/ together in a single request, unless the+-- value for /Select/ is 'SPECIFIC_ATTRIBUTES'. (This usage is equivalent+-- to specifying /AttributesToGet/ without any value for /Select/.)+--+-- If you use the /ProjectionExpression/ parameter, then the value for+-- /Select/ can only be 'SPECIFIC_ATTRIBUTES'. Any other value for /Select/+-- will return an error.+qSelect :: Lens' Query (Maybe Select)+qSelect = lens _qSelect (\ s a -> s{_qSelect = a});++-- | This is a legacy parameter, for backward compatibility. New applications+-- should use /FilterExpression/ instead. Do not combine legacy parameters+-- and expression parameters in a single API call; otherwise, DynamoDB will+-- return a /ValidationException/ exception.+--+-- A logical operator to apply to the conditions in a /QueryFilter/ map:+--+-- -   'AND' - If all of the conditions evaluate to true, then the entire+--     map evaluates to true.+--+-- -   'OR' - If at least one of the conditions evaluate to true, then the+--     entire map evaluates to true.+--+-- If you omit /ConditionalOperator/, then 'AND' is the default.+--+-- The operation will succeed only if the entire map evaluates to true.+--+-- This parameter does not support attributes of type List or Map.+qConditionalOperator :: Lens' Query (Maybe ConditionalOperator)+qConditionalOperator = lens _qConditionalOperator (\ s a -> s{_qConditionalOperator = a});++-- | The condition that specifies the key value(s) for items to be retrieved+-- by the /Query/ action.+--+-- The condition must perform an equality test on a single hash key value.+-- The condition can also perform one of several comparison tests on a+-- single range key value. /Query/ can use /KeyConditionExpression/ to+-- retrieve one item with a given hash and range key value, or several+-- items that have the same hash key value but different range key values.+--+-- The hash key equality test is required, and must be specified in the+-- following format:+--+-- 'hashAttributeName' /=/ ':hashval'+--+-- If you also want to provide a range key condition, it must be combined+-- using /AND/ with the hash key condition. Following is an example, using+-- the __=__ comparison operator for the range key:+--+-- 'hashAttributeName' /=/ ':hashval' /AND/ 'rangeAttributeName' /=/+-- ':rangeval'+--+-- Valid comparisons for the range key condition are as follows:+--+-- -   'rangeAttributeName' /=/ ':rangeval' - true if the range key is+--     equal to ':rangeval'.+--+-- -   'rangeAttributeName' /\</ ':rangeval' - true if the range key is+--     less than ':rangeval'.+--+-- -   'rangeAttributeName' /\<=/ ':rangeval' - true if the range key is+--     less than or equal to ':rangeval'.+--+-- -   'rangeAttributeName' />/ ':rangeval' - true if the range key is+--     greater than ':rangeval'.+--+-- -   'rangeAttributeName' />=/ ':rangeval' - true if the range key is+--     greater than or equal to ':rangeval'.+--+-- -   'rangeAttributeName' /BETWEEN/ ':rangeval1' /AND/ ':rangeval2' -+--     true if the range key is greater than or equal to ':rangeval1', and+--     less than or equal to ':rangeval2'.+--+-- -   /begins_with (/'rangeAttributeName', ':rangeval'/)/ - true if the+--     range key begins with a particular operand. (You cannot use this+--     function with a range key that is of type Number.) Note that the+--     function name 'begins_with' is case-sensitive.+--+-- Use the /ExpressionAttributeValues/ parameter to replace tokens such as+-- ':hashval' and ':rangeval' with actual values at runtime.+--+-- You can optionally use the /ExpressionAttributeNames/ parameter to+-- replace the names of the hash and range attributes with placeholder+-- tokens. This option might be necessary if an attribute name conflicts+-- with a DynamoDB reserved word. For example, the following+-- /KeyConditionExpression/ parameter causes an error because /Size/ is a+-- reserved word:+--+-- -   'Size = :myval'+--+-- To work around this, define a placeholder (such a '#S') to represent the+-- attribute name /Size/. /KeyConditionExpression/ then is as follows:+--+-- -   '#S = :myval'+--+-- For a list of reserved words, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ReservedWords.html Reserved Words>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- For more information on /ExpressionAttributeNames/ and+-- /ExpressionAttributeValues/, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ExpressionPlaceholders.html Using Placeholders for Attribute Names and Values>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- /KeyConditionExpression/ replaces the legacy /KeyConditions/ parameter.+qKeyConditionExpression :: Lens' Query (Maybe Text)+qKeyConditionExpression = lens _qKeyConditionExpression (\ s a -> s{_qKeyConditionExpression = a});++-- | The primary key of the first item that this operation will evaluate. Use+-- the value that was returned for /LastEvaluatedKey/ in the previous+-- operation.+--+-- The data type for /ExclusiveStartKey/ must be String, Number or Binary.+-- No set data types are allowed.+qExclusiveStartKey :: Lens' Query (HashMap Text AttributeValue)+qExclusiveStartKey = lens _qExclusiveStartKey (\ s a -> s{_qExclusiveStartKey = a}) . _Default . _Map;++-- | The name of an index to query. This index can be any local secondary+-- index or global secondary index on the table. Note that if you use the+-- /IndexName/ parameter, you must also provide /TableName./+qIndexName :: Lens' Query (Maybe Text)+qIndexName = lens _qIndexName (\ s a -> s{_qIndexName = a});++-- | The name of the table containing the requested items.+qTableName :: Lens' Query Text+qTableName = lens _qTableName (\ s a -> s{_qTableName = a});++instance AWSPager Query where+        page rq rs+          | stop (rs ^. qrsLastEvaluatedKey) = Nothing+          | stop (rs ^. qrsItems) = Nothing+          | otherwise =+            Just $ rq &+              qExclusiveStartKey .~ rs ^. qrsLastEvaluatedKey++instance AWSRequest Query where+        type Sv Query = DynamoDB+        type Rs Query = QueryResponse+        request = postJSON+        response+          = receiveJSON+              (\ s h x ->+                 QueryResponse' <$>+                   (x .?> "LastEvaluatedKey" .!@ mempty) <*>+                     (x .?> "Count")+                     <*> (x .?> "ScannedCount")+                     <*> (x .?> "Items" .!@ mempty)+                     <*> (x .?> "ConsumedCapacity")+                     <*> (pure (fromEnum s)))++instance ToHeaders Query where+        toHeaders+          = const+              (mconcat+                 ["X-Amz-Target" =#+                    ("DynamoDB_20120810.Query" :: ByteString),+                  "Content-Type" =#+                    ("application/x-amz-json-1.0" :: ByteString)])++instance ToJSON Query where+        toJSON Query'{..}+          = object+              ["ProjectionExpression" .= _qProjectionExpression,+               "KeyConditions" .= _qKeyConditions,+               "FilterExpression" .= _qFilterExpression,+               "QueryFilter" .= _qQueryFilter,+               "ConsistentRead" .= _qConsistentRead,+               "ExpressionAttributeNames" .=+                 _qExpressionAttributeNames,+               "AttributesToGet" .= _qAttributesToGet,+               "ReturnConsumedCapacity" .= _qReturnConsumedCapacity,+               "ExpressionAttributeValues" .=+                 _qExpressionAttributeValues,+               "ScanIndexForward" .= _qScanIndexForward,+               "Limit" .= _qLimit, "Select" .= _qSelect,+               "ConditionalOperator" .= _qConditionalOperator,+               "KeyConditionExpression" .= _qKeyConditionExpression,+               "ExclusiveStartKey" .= _qExclusiveStartKey,+               "IndexName" .= _qIndexName,+               "TableName" .= _qTableName]++instance ToPath Query where+        toPath = const "/"++instance ToQuery Query where+        toQuery = const mempty++-- | Represents the output of a /Query/ operation.+--+-- /See:/ 'queryResponse' smart constructor.+data QueryResponse = QueryResponse'+    { _qrsLastEvaluatedKey :: !(Maybe (Map Text AttributeValue))+    , _qrsCount            :: !(Maybe Int)+    , _qrsScannedCount     :: !(Maybe Int)+    , _qrsItems            :: !(Maybe [Map Text AttributeValue])+    , _qrsConsumedCapacity :: !(Maybe ConsumedCapacity)+    , _qrsStatus           :: !Int+    } deriving (Eq,Read,Show,Data,Typeable,Generic)++-- | Creates a value of 'QueryResponse' with the minimum fields required to make a request.+--+-- Use one of the following lenses to modify other fields as desired:+--+-- * 'qrsLastEvaluatedKey'+--+-- * 'qrsCount'+--+-- * 'qrsScannedCount'+--+-- * 'qrsItems'+--+-- * 'qrsConsumedCapacity'+--+-- * 'qrsStatus'+queryResponse+    :: Int -- ^ 'qrsStatus'+    -> QueryResponse+queryResponse pStatus_ =+    QueryResponse'+    { _qrsLastEvaluatedKey = Nothing+    , _qrsCount = Nothing+    , _qrsScannedCount = Nothing+    , _qrsItems = Nothing+    , _qrsConsumedCapacity = Nothing+    , _qrsStatus = pStatus_+    }++-- | The primary key of the item where the operation stopped, inclusive of+-- the previous result set. Use this value to start a new operation,+-- excluding this value in the new request.+--+-- If /LastEvaluatedKey/ is empty, then the \"last page\" of results has+-- been processed and there is no more data to be retrieved.+--+-- If /LastEvaluatedKey/ is not empty, it does not necessarily mean that+-- there is more data in the result set. The only way to know when you have+-- reached the end of the result set is when /LastEvaluatedKey/ is empty.+qrsLastEvaluatedKey :: Lens' QueryResponse (HashMap Text AttributeValue)+qrsLastEvaluatedKey = lens _qrsLastEvaluatedKey (\ s a -> s{_qrsLastEvaluatedKey = a}) . _Default . _Map;++-- | The number of items in the response.+--+-- If you used a /QueryFilter/ in the request, then /Count/ is the number+-- of items returned after the filter was applied, and /ScannedCount/ is+-- the number of matching items before> the filter was applied.+--+-- If you did not use a filter in the request, then /Count/ and+-- /ScannedCount/ are the same.+qrsCount :: Lens' QueryResponse (Maybe Int)+qrsCount = lens _qrsCount (\ s a -> s{_qrsCount = a});++-- | The number of items evaluated, before any /QueryFilter/ is applied. A+-- high /ScannedCount/ value with few, or no, /Count/ results indicates an+-- inefficient /Query/ operation. For more information, see+-- <http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Count Count and ScannedCount>+-- in the /Amazon DynamoDB Developer Guide/.+--+-- If you did not use a filter in the request, then /ScannedCount/ is the+-- same as /Count/.+qrsScannedCount :: Lens' QueryResponse (Maybe Int)+qrsScannedCount = lens _qrsScannedCount (\ s a -> s{_qrsScannedCount = a});++-- | An array of item attributes that match the query criteria. Each element+-- in this array consists of an attribute name and the value for that+-- attribute.+qrsItems :: Lens' QueryResponse [HashMap Text AttributeValue]+qrsItems = lens _qrsItems (\ s a -> s{_qrsItems = a}) . _Default . _Coerce;++-- | Undocumented member.+qrsConsumedCapacity :: Lens' QueryResponse (Maybe ConsumedCapacity)+qrsConsumedCapacity = lens _qrsConsumedCapacity (\ s a -> s{_qrsConsumedCapacity = a});++-- | The response status code.+qrsStatus :: Lens' QueryResponse Int+qrsStatus = lens _qrsStatus (\ s a -> s{_qrsStatus = a});