Run Amazon SQS messages

Tricentis Tosca API Scan enables you to run messages dynamically using an Amazon SQS connection.

To use Amazon SQS, you need to create the following in advance: An AWS account. An access key created at Identity and Access Management (IAM) cloud. An SQS queue. The following types of message queues are available: Standard Queues. FIFO Queues (currently not supported in API Scan). For more information on Amazon SQS-related timing, check Amazon SQS Visibility Timeout. Also see Amazon AWS documentation.

To run Amazon SQS messages, choose one of the following connection types and follow the steps below.

Methods: Push and pull actions.

Option 1 - Run Amazon SQS messages with predefined connection

Push messages

To push messages with predefined Amazon SQS messages, follow the steps below:

1. Create a new message.

2. In the Connection section, go to Manage to create an Amazon SQS connection.

3. From the Connection drop-down menu, select your connection.

4. In the Action drop-down menu, select Push. The Endpoint field displays the ARN.

5. In the Payload field, request your message.

6. Click on Run in the API Scan menu to send your message to the specified queue.

Pull messages

To pull messages with predefined Amazon SQS messages, follow the steps below:

1. Create a new message.

2. In the Connection section, go to Manage in order to create an Amazon SQS connection.

3. From the Connection drop-down menu, select your connection.

4. In the Action drop-down menu, select Pull. The Endpoint field displays the ARN.

5. Click on Run in the API Scan menu to receive your message in the specified queue. Only one message is retrieved at the time. To retrieve multiple messages, create a Loop. Also see Amazon SQS Visibility Timeout.

Option 2 - Run Amazon SQS messages with non-predefined connection

Push messages

To push messages with non-predefined Amazon SQS messages, follow the steps below:

1. Create a new message.

2. From the Connection drop-down menu, select <explicit>.

3. In the Endpoint field, copy the Amazon Resource Name (ARN) of your selected SQS queue from the AWS console in the Details tab.

4. In the Action drop-down menu, select Push.

5. In the Auth tab, choose AmazonSignature from the Authentication drop-down list and enter Access Key and Secret Key credentials for your AWS account.

6. In the Payload field, request your message.

7. Click on Run in the API Scan menu to send your message on the queue to the specified queue.

Pull messages

To pull messages with non-predefined Amazon SQS messages, follow the steps below:

1. Create a new message.

2. From the Connection drop-down menu, select <explicit>.

3. In the Endpoint field, copy the Amazon Resource Name (ARN) of your selected SQS queue from the AWS console in the Details tab.

4. In the Action drop-down menu, select Pull.

5. In the Auth tab, choose AmazonSignature from the Authentication drop-down list and enter Access Key and Secret Key credentials for your AWS account.

6. Click on Run in the API Scan menu to receive your message in the specified queue. Only one message is retrieved at the time. To retrieve multiple messages, create a Loop. Also see Amazon SQS Visibility Timeout.

After running your Amazon SQS messages in API Scan, you can export them to Tosca Commander. This allows you to use the message information to define Module Attributes and verify their values. Depending on what you want to test, you can export the messages as an API TestCase.