Skip to main content

aws-sqs

Latest Versionv1.0.0
Input Content TypeAny
Incurs Usage

Sending data to AWS SQS incurs usage costs after exceeding the free tier. See Golioth pricing for more information.

The aws-sqs destination sends data to an Amazon Web Services Simple Queue Service queue.

Parameters

ParameterTypeDescriptionRequired
urlstringThe URL for the AWS SQS queue.
access_keystringThe access key for authentication.
access_secretstringThe access secret for authentication.
regionstringThe AWS region for the SQS queue.

Example Secrets

AWS_ACCESS_SECRET

wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Example Usage

    destination:
type: aws-sqs
version: v1
parameters:
url: https://sqs.us-east-1.amazonaws.com/177715257436/MyQueue
access_key: AKIAIOSFODNN7EXAMPLE
access_secret: $AWS_ACCESS_SECRET
region: us-east-1

Example Input

{
"temp": 32
}

Example Output

Data messages delivered to AWS SQS are in the form of a JSON encoded CloudEvent. If the device data payload is application/json, it will be included as a nested JSON object under the data key.

{
"specversion": "1.0",
"id": "aa12dc4c-c5ed-4b46-92e5-5a726f4daa81",
"source": "12345678987654321",
"type": "io.golioth.data.v1/.s/sensor",
"subject": "my-first-project",
"datacontenttype": "application/json",
"time": "2022-01-27T16:17:06.458868Z",
"data": {"temp": 32}
}

Payloads with non-JSON content will be base64 encoded and present in the data_base64 field of the JSON object.

{
"specversion": "1.0",
"id": "aa12dc4c-c5ed-4b46-92e5-5a726f4daa81",
"source": "12345678987654321",
"type": "io.golioth.data.v1/.s/sensor",
"subject": "my-first-project",
"datacontenttype": "application/octet-stream",
"time": "2022-01-27T16:17:06.458868Z",
"data_base64": "aHR0cHM6Ly9nb2xpb3RoLmlvL2NhcmVlcnMK"
}