Amazon::SQS::Simple - OO API for accessing the Amazon Simple Queue Service

NAME
SYNOPSIS
INTRODUCTION
CONSTRUCTOR
METHODS
FUNCTIONS
STANDARD OPTIONS
AUTHOR

NAME

SYNOPSIS

    use Amazon::SQS::Simple;

    my $access_key = 'foo'; # Your AWS Access Key ID
    my $secret_key = 'bar'; # Your AWS Secret Key
    
    # Create an SQS object
    my $sqs = new Amazon::SQS::Simple($access_key, $secret_key);

    # Create a new queue
    my $q = $sqs->CreateQueue('queue_name');

    # Send a message
    $q->SendMessage('Hello world!');

    # Retrieve a message
    my $msg = $q->ReceiveMessage();
    print $msg->MessageBody() # Hello world!

    # Delete the message
    $q->DeleteMessage($msg->MessageId());

    # Delete the queue
    $q->Delete();

INTRODUCTION

Amazon::SQS::Simple is an OO API for the Amazon Simple Queue Service.

CONSTRUCTOR

new($access_key, $secret_key): Constructs a new Amazon::SQS::Simple object; $access_key is your Amazon Web Services access key. $secret_key is your Amazon Web Services secret key. If you don't have either of these credentials, visit http://aws.amazon.com/.

METHODS

GetQueue($queue_endpoint): Gets the queue with the given endpoint. Returns a Amazon::SQS::Simple::Queue object. (See the Amazon::SQS::Simple::Queue manpage for details.)
CreateQueue($queue_name, [%opts]): Creates a new queue with the given name. Returns a Amazon::SQS::Simple::Queue object. (See the Amazon::SQS::Simple::Queue manpage for details.); Options for CreateQueue:
ListQueues([%opts]): Gets a list of all your current queues. Returns an array of Amazon::SQS::Simple::Queue objects. (See the Amazon::SQS::Simple::Queue manpage for details.); Options for ListQueues:

FUNCTIONS

No functions are exported by default; if you want to use them, export them in your use line:

    use Amazon::SQS::Simple qw( timestamp );

timestamp($seconds): Takes a time in seconds since the epoch and returns a formatted timestamp suitable for using in a Timestamp or Expires optional method parameter.

STANDARD OPTIONS

The following options can be supplied with any of the listed methods.

AWSAccessKeyId => STRING: The AWS Access Key Id to use with the method call. If not provided, Amazon::SQS::Simple uses the value passed to the constructor.
SecretKey => STRING: The Secret Key to use with the method call. If not provided, Amazon::SQS::Simple uses the value passed to the constructor.
Timestamp => TIMESTAMP: All methods are automatically given a timestamp of the time at which they are called, but you can override this value if you need to. The value for this key should be a timestamp as returned by the Amazon::SQS::Simple::timestamp() function.; You generally do not need to supply this option.
Expires => TIMESTAMP: All methods are automatically given a timestamp of the time at which they are called. You can alternatively set an expiry time by providing an Expires option. The value for this key should be a timestamp as returned by the Amazon::SQS::Simple::timestamp() function.; You generally do not need to supply this option.

AUTHOR

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