NAME

Amazon::SimpleDB::Domain - a class representing a domain in SimpleDB

DESCRIPTION

This is code is in the early stages of development. Do not consider it stable. Feedback and patches welcome.

METHODS

Amazon::SimpleDB::Domain->new($args)

Constructor for a domain. Takes a required HASHREF with two required keys:

account: An Amazon::SimpleDB account object the item is to be associated.
name: The name of the domain for the constructed object.

Typically this method will not be called directly by a developer, but rather other parts of the Amazon::SimpleDB package.

This method does not check if an domain exists and is accessible.

$domain->account

Returns a reference to the Amazon::SimpleDB account object.

$domain->name

Returns the domain name of the object.

$domain->delete

Deletes the domain from SimpleDB that this object represents.

This is an alias "$domain-"account->delete_bucket($domain->name)>.

$domain->query([$args])

Queries the item in the domain and returns matching items according to the optional arguments HASHREF. If nothing is passed in all items in the domain are returned.

The arguments HASHREF can have these three keys:

query: A SimpleDB query expression string.
limit: A number between 1 and 250 that defines the maximum number of items to return in a single request. The SimpleDB default is 100.
next: A "next token" from a previous request that can be used to retrieve more items when the results of a query exceeds the limit.

AUTHOR & COPYRIGHT

Please see the Amazon::SimpleDB manpage for author, copyright, and license information.