|
Amazon SQS - Send message |
Declaration
<AMAWSSQS PROVIDER="session_based" SESSION="text" ACCESSKEY="text" SECRETKEY="text (encrypted)" USERAGENT="text" MAXERRORRETRY="number" SERVICEURL="text" PROXYHOST="text" PROXYPORT="number" PROXYUSER="text" PROXYPWD="text (encrypted)" SIGNMETHOD="text" SIGNVERSION="number" QUEUEURL="text" DATA="text" RESULTDATASET="text" />
Description
Delivers a message to the specified queue.
Practical Usage
Used to send a queue message. Note that the maximum allowed message size is 8 KB.
Parameters
Connection
Property | Type | Required | Default | Markup | Description |
---|---|---|---|---|---|
Connection | --- | --- | --- | --- | Indicates
where AWS user credentials and preferences should originate from.
This is a design mode parameter used only during task construction
and configuration, thus, comprises no markup. The available options
are:
|
Session | Text | Yes, if Connection is set to Session | SQSSession1 | SESSION="SQSession1" | The name of an existing session to attach this activity to. This parameter is active only if the Connection parameter is set to Session. The default session name is 'SQSSession1'. |
Access key | Text | Yes, if Connection is set to Host | (Empty) | ACCESSKEY="022QF06E7MXBSH9DHM02" | A 20-character alphanumeric string that uniquely identifies the owner of the AWS service account, similar to a username. This key along with a corresponding secret access key forms a secure information set that AWS uses to confirm a valid user's identity. This parameter is active only if the Connection parameter is set to Host. |
Secret access key | Text | Yes, if Connection is set to Host | (Empty) | SECRETKEY="kWcrlUX5JEDGM/LtmEENI/aVmYvHNif5zB+d9+ct" | A 40-character string that serves the role as password to access the AWS service account. This along with an associated access key forms a secure information set that SQS uses to confirm a valid user's identity. This parameter is active only if the Connection parameter is set to Host. |
User agent | Text | No | Automate | USERAGENT="Automate" | The name of the client or application initiating requests to AWS, which in this case, is Automate. This parameter's default value is 'Automate'. |
Service URL | Text | No | (Empty) | SERVICEURL="https://sqs.eu-west-1.amazonaws.com" | The URL that provides the service endpoint. To make the service call to a different region, you can pass the region-specific endpoint URL. For example, entering https://sqs.us-west-1.amazonaws.com points to US West (Northern California) region. A complete list of SQS regions, along with their associated endpoints and valid protocols can be found below under SQS Endpoints and Regions. |
Maximum number of retries on error | Number | No | (Empty) | MAXERRORRETRY="4" | The total amount of times this activity should retry its request to the server before returning an error. Network components can generate errors anytime in the life of a request, thus, implementing retries can increase reliability. |
Proxy host | Text | No | (Empty) | PROXYHOST="proxy.host.com" | The host name (for example, server.domain.com) or IP address (for example, xxx.xxx.xxx.xxx) of the proxy server to use when connecting to AWS. |
Proxy port | Number | No | (Empty) | PROXYPORT="1028" | The port that should be used to connect to the proxy server. |
Proxy username | Text | No | (Empty) | PROXYUSER="username" | The username that should be used to authenticate connection with the proxy server (if required). |
Proxy password | Text | No | (Empty) | PROXYPWD="encrypted" | The password that should be used to authenticate connection with the proxy server (if required). |
Signature method | Text | No | (Empty) | SIGNMETHOD="HmacSHA256" | The signature method to use for signing the request. This provides a valid hashing algorithm for signature calculation. Acceptable AWS signature methods are HmacSHA1 and HmacSHA256. |
Signature version | Number | No | (Empty) | SIGNVERSION="2" | The signature version for signing the request. Valid AWS signature versions are 2 and 4. The difference with version 4 is that it allows you to sign your message using a key that is derived from your secret access key rather than using the secret access key itself. |
Queue
Property | Type | Required | Default | Markup | Description |
---|---|---|---|---|---|
Queue URL | Text | Yes | (Empty) | QUEUEURL="https://queue.amazonaws.com/963068290131/TestSNSNotification" | The URL uniquely identifying the queue, which includes the queue name and other components that SQS determines. |
Message Data (Max 8 KB) | Text | Yes | (Empty) | DATA="This is the message" | The message to send. |
Create and populate dataset with SQS message information | Text | No | (Empty) | RESULTDATASET="theDataset" | The name of the dataset to create and populate with information about the SQS message being sent. More details regarding this dataset can be found below under Datasets. |
Additional Notes
SQS Endpoints and Regions
This table contains a complete list of Amazon Simple Queue Service endpoints, along with their corresponding regions and supported protocols.
Endpoint | Region | Protocol |
---|---|---|
sqs.us-east-1.amazonaws.com | US East (Northern Virginia) Region | HTTP and HTTPS |
sqs.us-west-2.amazonaws.com | US West (Oregon) Region | HTTP and HTTPS |
sqs.us-west-1.amazonaws.com | US West (Northern California) Region | HTTP and HTTPS |
sqs.eu-west-1.amazonaws.com | EU (Ireland) Region | HTTP and HTTPS |
sqs.ap-southeast-1.amazonaws.com | Asia Pacific (Singapore) Region | HTTP and HTTPS |
sqs.ap-southeast-2.amazonaws.com | Asia Pacific (Sydney) Region | HTTP and HTTPS |
sqs.ap-northeast-1.amazonaws.com | Asia Pacific (Tokyo) Region | HTTP and HTTPS |
sqs.sa-east-1.amazonaws.com | South America (Sao Paulo) Region | HTTP and HTTPS |
Datasets
A dataset is a multiple column, multiple row container object. This activity creates and populates a dataset containing a specific set of fields in addition to the standard dataset fields. The table below describes these fields (assuming the name of the created and assigned dataset is "theDataset").
Name | Type | Return Value |
---|---|---|
theDataset.Body | Text | The message body. |
theDataset.MD5OfBody | Text | An MD5 digest of the non-URL-encoded message body string (i.e. 1c531e2d189cdcb9ec81ef36f4c22d85). You can use this to verify that SQS received the message correctly. |
theDataset.MessageID | Text | An element containing the message ID of the message sent to the queue (i.e. e07cab7e-aa08-469b-aa53-73978906e0bd). |
Example
- The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
- Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.
Description
This sample tasks sends a message and then creates and populates a dataset with the message information.
<AMAWSSQS PROVIDER="session_based" SESSION="SQSSession1" QUEUEURL=""https://queue.amazonaws.com/QueueID"" DATA="This is the message" RESULTDATASET="theDataset" />