serverless/docs/providers/aws/events/iot.md

Read this on the main serverless docs site

IoT

Simple event definition

This will enable your Lambda function to be called by an AWS IoT rule.

functions:
  myIoT:
    handler: myIoT.handler
    events:
      - iot:
          sql: "SELECT * FROM 'some_topic'"

Enabling / Disabling

Note: iot events are enabled by default.

This will create and attach a disabled iot event for the myIoT function.

functions:
  myIoT:
    handler: myIoT.handler
    events:
      - iot:
          sql: "SELECT * FROM 'some_topic'"
          enabled: false

Specify Name and Description

Name and Description can be specified with the help of the name and description properties.

functions:
  myIoT:
    handler: myIoT.handler
    events:
      - iot:
          name: 'myIotEvent'
          sql: "SELECT * FROM 'some_topic'"
          description: 'My IoT Event Description'

Specify SQL Versions

SQL Versions can be specified for an iot event. However the sqlVersion is not a required property.

functions:
  myIoT:
    handler: myIoT.handler
    events:
      - iot:
          sql: "SELECT * FROM 'some_topic'"
          sqlVersion: 'beta'