About this Library

• Based on the 2009-04-15 API version.

What's New?

• 2010-01-19: Added support for new strong consistency features: consistent read and conditional put/delete
• 2009-05-07: Deprecate Query and QueryWithAttributes. Please migrate to Select API
• 2009-03-23: Support for BatchPutAttributes
• 2008-12-26: Url and utf8 encoding fix for signature version 2
• 2008-12-17: Support for signature version 2, DomainMetadata and Select API, https endpoint
• 2008-08-28: Support for new API - QueryWithAttributes

Prerequisites

• Amazon SimpleDB account (http://aws.amazon.com/simpledb).
• Perl 5.6.0 or newer (http://www.perl.org/)
• Depending on the version of PERL you are using, you may need to install additional packages. To install additional packages, run following command:
  • perl -MCPAN -e 'install Digest::SHA'
  • perl -MCPAN -e 'install XML::Simple'
  • perl -MCPAN -e 'install Bundle::LWP'
  • perl -MCPAN -e 'install Crypt::SSLeay'

Package Content

Quick Start

1. Extract the amazon-simpledb-2009-04-15-perl-library.zip file into a working directory.
2. Edit desired sample. For example: src/Amazon/SimpleDB/Samples/CreateDomainSample.pl



• Set AWS Access Key ID and AWS Secret Access Key

 my $AWS_ACCESS_KEY_ID        = "<Your Access Key ID>";
 my $AWS_SECRET_ACCESS_KEY    = "<Your Secret Access Key>";
                




• Set request parameters. For example, find following pre-generated snippet:

 use Amazon::SimpleDB::Model::CreateDomainRequest;
 # @TODO: set request. request can be passed as Amazon::SimpleDB::Model::CreateDomainRequest
 # object or hash of parameters
 # invokeCreateDomain($service, $request);
                




• And set request with DomainName parameter:

 use Amazon::SimpleDB::Model::CreateDomainRequest;
 my $request = Amazon::SimpleDB::Model::CreateDomainRequest->new;
 invokeCreateDomain($service, $request->withDomainName("MyDomain"));
                



3. Run CreateDomain sample:

   perl src/Amazon/SimpleDB/Samples/CreateDomainSample.pl
            

4. You should see the output similar to the following:




    CreateDomainResponse
        ResponseMetadata
            RequestId
                95cdcb68-f46c-400b-8265-8c2de2a5c475
            



5. Experiment with samples. When ready, install library in the perl include path and use it.

Notes

    my $request = Amazon::SimpleDB::Model::CreateDomainRequest->new;
    $request->setDomainName("MyDomain");
    my $response = $service->createDomain($request);
        

    my $response = $service->createDomain({DomainName => "MyDomain"});
        

Happy coding!

Comments, Questions or Feedback