Amazonka.SDB.BatchPutAttributes

The BatchPutAttributes operation creates or replaces attributes within one or more items. By using this operation, the client can perform multiple PutAttribute operation with a single call. This helps yield savings in round trips and latencies, enabling Amazon SimpleDB to optimize requests and generally produce better throughput.

The client may specify the item name with the Item.X.ItemName parameter. The client may specify new attributes using a combination of the Item.X.Attribute.Y.Name and Item.X.Attribute.Y.Value parameters. The client may specify the first attribute for the first item using the parameters Item.0.Attribute.0.Name and Item.0.Attribute.0.Value, and for the second attribute for the first item by the parameters Item.0.Attribute.1.Name and Item.0.Attribute.1.Value, and so on.

Attributes are uniquely identified within an item by their name/value combination. For example, a single item can have the attributes { "first_name", "first_value" } and { "first_name", "second_value" }. However, it cannot have two attribute instances where both the Item.X.Attribute.Y.Name and Item.X.Attribute.Y.Value are the same.

Optionally, the requester can supply the Replace parameter for each individual value. Setting this value to true will cause the new attribute values to replace the existing attribute values. For example, if an item I has the attributes { 'a', '1' }, { 'b', '2'} and { 'b', '3' } and the requester does a BatchPutAttributes of {'I', 'b', '4' } with the Replace parameter set to true, the final attributes of the item will be { 'a', '1' } and { 'b', '4' }, replacing the previous values of the 'b' attribute with the new value.

This operation is vulnerable to exceeding the maximum URL size when making a REST request using the HTTP GET method. This operation does not support conditions using Expected.X.Name, Expected.X.Value, or Expected.X.Exists.

You can execute multiple BatchPutAttributes operations and other operations in parallel. However, large numbers of concurrent BatchPutAttributes calls can result in Service Unavailable (503) responses.

The following limitations are enforced for this operation:

• 256 attribute name-value pairs per item
• 1 MB request size
• 1 billion attributes per domain
• 10 GB of total user data storage per domain
• 25 item limit per BatchPutAttributes operation

Creating a Request

data BatchPutAttributes

See: newBatchPutAttributes smart constructor.

Constructors

BatchPutAttributes'

Fields

• domainName :: Text

  The name of the domain in which the attributes are being stored.

• items :: [ReplaceableItem]

  A list of items on which to perform the operation.

Instances

ToHeaders BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

toHeaders :: BatchPutAttributes -> [Header]

ToPath BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

toPath :: BatchPutAttributes -> ByteString

ToQuery BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

toQuery :: BatchPutAttributes -> QueryString

AWSRequest BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Associated Types

type AWSResponse BatchPutAttributes

Methods

request :: (Service -> Service) -> BatchPutAttributes -> Request BatchPutAttributes

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy BatchPutAttributes -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse BatchPutAttributes)))

Generic BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Associated Types

type Rep BatchPutAttributes :: Type -> Type

Methods

from :: BatchPutAttributes -> Rep BatchPutAttributes x

to :: Rep BatchPutAttributes x -> BatchPutAttributes

Read BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

readsPrec :: Int -> ReadS BatchPutAttributes

readList :: ReadS [BatchPutAttributes]

readPrec :: ReadPrec BatchPutAttributes

readListPrec :: ReadPrec [BatchPutAttributes]

Show BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

showsPrec :: Int -> BatchPutAttributes -> ShowS

show :: BatchPutAttributes -> String

showList :: [BatchPutAttributes] -> ShowS

NFData BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

rnf :: BatchPutAttributes -> ()

Eq BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

(==) :: BatchPutAttributes -> BatchPutAttributes -> Bool

(/=) :: BatchPutAttributes -> BatchPutAttributes -> Bool

Hashable BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

Methods

hashWithSalt :: Int -> BatchPutAttributes -> Int

hash :: BatchPutAttributes -> Int

type AWSResponse BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

type AWSResponse BatchPutAttributes = BatchPutAttributesResponse

type Rep BatchPutAttributes

Defined in Amazonka.SDB.BatchPutAttributes

type Rep BatchPutAttributes = D1 ('MetaData "BatchPutAttributes" "Amazonka.SDB.BatchPutAttributes" "amazonka-sdb-2.0-7a0e7nVPNy1GutfrhcqnW8" 'False) (C1 ('MetaCons "BatchPutAttributes'" 'PrefixI 'True) (S1 ('MetaSel ('Just "domainName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "items") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [ReplaceableItem])))

newBatchPutAttributes

Arguments

:: Text

$sel:domainName:BatchPutAttributes'

-> BatchPutAttributes

Create a value of BatchPutAttributes with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:domainName:BatchPutAttributes', batchPutAttributes_domainName - The name of the domain in which the attributes are being stored.

$sel:items:BatchPutAttributes', batchPutAttributes_items - A list of items on which to perform the operation.

Request Lenses

batchPutAttributes_domainName :: Lens' BatchPutAttributes Text

The name of the domain in which the attributes are being stored.

batchPutAttributes_items :: Lens' BatchPutAttributes [ReplaceableItem]

A list of items on which to perform the operation.

Destructuring the Response

data BatchPutAttributesResponse

See: newBatchPutAttributesResponse smart constructor.

Constructors

BatchPutAttributesResponse'

Instances

Generic BatchPutAttributesResponse

Defined in Amazonka.SDB.BatchPutAttributes

Associated Types

type Rep BatchPutAttributesResponse :: Type -> Type

Methods

from :: BatchPutAttributesResponse -> Rep BatchPutAttributesResponse x

to :: Rep BatchPutAttributesResponse x -> BatchPutAttributesResponse

Read BatchPutAttributesResponse

Defined in Amazonka.SDB.BatchPutAttributes

Methods

readsPrec :: Int -> ReadS BatchPutAttributesResponse

readList :: ReadS [BatchPutAttributesResponse]

readPrec :: ReadPrec BatchPutAttributesResponse

readListPrec :: ReadPrec [BatchPutAttributesResponse]

Show BatchPutAttributesResponse

Defined in Amazonka.SDB.BatchPutAttributes

Methods

showsPrec :: Int -> BatchPutAttributesResponse -> ShowS

show :: BatchPutAttributesResponse -> String

showList :: [BatchPutAttributesResponse] -> ShowS

NFData BatchPutAttributesResponse

Defined in Amazonka.SDB.BatchPutAttributes

Methods

rnf :: BatchPutAttributesResponse -> ()

Eq BatchPutAttributesResponse

Defined in Amazonka.SDB.BatchPutAttributes

Methods

(==) :: BatchPutAttributesResponse -> BatchPutAttributesResponse -> Bool

(/=) :: BatchPutAttributesResponse -> BatchPutAttributesResponse -> Bool

type Rep BatchPutAttributesResponse

Defined in Amazonka.SDB.BatchPutAttributes

type Rep BatchPutAttributesResponse = D1 ('MetaData "BatchPutAttributesResponse" "Amazonka.SDB.BatchPutAttributes" "amazonka-sdb-2.0-7a0e7nVPNy1GutfrhcqnW8" 'False) (C1 ('MetaCons "BatchPutAttributesResponse'" 'PrefixI 'False) (U1 :: Type -> Type))

newBatchPutAttributesResponse :: BatchPutAttributesResponse

Create a value of BatchPutAttributesResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.