NAME

Amazon::DynamoDB - API support for Amazon DynamoDB

VERSION

version 0.35

SYNOPSIS

  my $ddb = Amazon::DynamoDB->new(
     implementation => 'Amazon::DynamoDB::LWP',
     version        => '20120810',

     access_key     => 'access_key',
     secret_key     => 'secret_key',
     # or you specify to use an IAM role
     use_iam_role   => 1, 

     host => 'dynamodb.us-east-1.amazonaws.com',
     scope => 'us-east-1/dynamodb/aws4_request',
     ssl => 1,
     debug => 1);

  $ddb->batch_get_item(
     sub {
       my $tbl = shift;
       my $data = shift;
       print "Batch get: $tbl had " . join(',', %$data) . "\n";
     },
     RequestItems => {
       $table_name => { 
         Keys => [
           { 
             name => 'some test name here',
           }
         ],
         AttributesToGet => [qw(name age)],
       }
      })->get;

DESCRIPTION

Provides a Future-based API for Amazon's DynamoDB REST API. See Amazon::DynamoDB::20120810 for available methods.

Current implementations for issuing the HTTP requests:

NAME

Amazon::DynamoDB - support for the AWS DynamoDB API

METHODS

SEE ALSO

IMPLEMENTATION PHILOSOPHY

This module attempts to stick as close to Amazon's API as possible while making some inconvenient limits easy to work with.

Parameters are named the same, return values are as described. Documentation for each method is commonly found at:

http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Operations.html

For examples see the test cases, most functionality is well exercised via tests.

AUTHORS

  • Rusty Conover <rusty@luckydinosaur.com>

  • Tom Molesworth <cpan@entitymodel.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Tom Molesworth, copyright (c) 2014 Lucky Dinosaur LLC. http://www.luckydinosaur.com.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.