Files
pycom-documentation/pybytes/integrations/amazon-iot.md
2018-10-29 15:52:15 +00:00

25 lines
1.6 KiB
Markdown

# Amazon IoT
Whenever one of your integrated devices sends a message to our broker, we republish the binary payload to the endpoint specified for its integration. In order to save the data received by AWS, [you must set up a rule](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html). You can also test that everything's working with the [AWS IoT MQTT client](https://docs.aws.amazon.com/iot/latest/developerguide/view-mqtt-messages.html).
**Warning**: do not delete AWS things or groups directly from AWS user interface, otherwise the integration with Pybytes will stop working. Always use Pybytes interface to delete AWS things or groups.
## Integrate your devices
1. Go in the sidebar, click on _New Integration_ and then on _Amazon Web Services_
![](../../.gitbook/assets/01_aws_integration.png)
2. Fill in the form choosing an [AWS region](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) and your AWS credentials. You can optionally choose to save them inside the local storage for future use. Once you're done, click _Login_
![](../../.gitbook/assets/02_aws_integration.png)
3. In this step, you have to specify the [AWS group](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) name \(just alphanumeric letter, dashes and underscore are allowed\), the custom topic and the devices you want to bind to AWS. When you're ready, click _Create_
![](../../.gitbook/assets/03_aws_integration.png)
4. If everything's worked as expected, you should be able to see a summary of your integration like the following:
![](../../.gitbook/assets/04_aws_integration.png)