Expand description
AWS IoT Events monitors your equipment or device fleets for failures or changes in operation, and triggers actions when such events occur. You can use AWS IoT Events API operations to create, read, update, and delete inputs and detector models, and to list their versions.
If you’re using the service, you’re probably looking for IotEventsClient and IotEvents.
Structs§
- Action
An action to be performed when the
condition
is TRUE.- Asset
Property Timestamp A structure that contains timestamp information. For more information, see TimeInNanos in the AWS IoT SiteWise API Reference.
For parameters that are string data type, you can specify the following options:
-
Use a string. For example, the
timeInSeconds
value can be'1586400675'
. -
Use an expression. For example, the
timeInSeconds
value can be'${$input.TemperatureInput.sensorData.timestamp/1000}'
.For more information, see Expressions in the AWS IoT Events Developer Guide.
-
- Asset
Property Value A structure that contains value information. For more information, see AssetPropertyValue in the AWS IoT SiteWise API Reference.
For parameters that are string data type, you can specify the following options:
-
Use a string. For example, the
quality
value can be'GOOD'
. -
Use an expression. For example, the
quality
value can be$input.TemperatureInput.sensorData.quality
.For more information, see Expressions in the AWS IoT Events Developer Guide.
-
- Asset
Property Variant A structure that contains an asset property value. For more information, see Variant in the AWS IoT SiteWise API Reference.
You must specify one of the following value types, depending on the
dataType
of the specified asset property. For more information, see AssetProperty in the AWS IoT SiteWise API Reference.For parameters that are string data type, you can specify the following options:
-
Use a string. For example, the
doubleValue
value can be'47.9'
. -
Use an expression. For example, the
doubleValue
value can be$input.TemperatureInput.sensorData.temperature
.For more information, see Expressions in the AWS IoT Events Developer Guide.
-
- Attribute
The attributes from the JSON payload that are made available by the input. Inputs are derived from messages sent to the AWS IoT Events system using
BatchPutMessage
. Each such message contains a JSON payload. Those attributes (and their paired values) specified here are available for use in thecondition
expressions used by detectors.- Clear
Timer Action Information needed to clear the timer.
- Create
Detector Model Request - Create
Detector Model Response - Create
Input Request - Create
Input Response - Delete
Detector Model Request - Delete
Detector Model Response - Delete
Input Request - Delete
Input Response - Describe
Detector Model Request - Describe
Detector Model Response - Describe
Input Request - Describe
Input Response - Describe
Logging Options Request - Describe
Logging Options Response - Detector
Debug Option The detector model and the specific detectors (instances) for which the logging level is given.
- Detector
Model Information about the detector model.
- Detector
Model Configuration Information about how the detector model is configured.
- Detector
Model Definition Information that defines how a detector operates.
- Detector
Model Summary Information about the detector model.
- Detector
Model Version Summary Information about the detector model version.
- DynamoDB
Action Defines an action to write to the Amazon DynamoDB table that you created. The standard action payload contains all attribute-value pairs that have the information about the detector model instance and the event that triggered the action. You can also customize the payload. One column of the DynamoDB table receives all attribute-value pairs in the payload that you specify.
The
tableName
andhashKeyField
values must match the table name and the partition key of the DynamoDB table.If the DynamoDB table also has a sort key, you must specify
rangeKeyField
. TherangeKeyField
value must match the sort key.The
hashKeyValue
andrangeKeyValue
use substitution templates. These templates provide data at runtime. The syntax is${sql-expression}
.You can use expressions for parameters that are string data type. For more information, see Expressions in the AWS IoT Events Developer Guide.
If the defined payload type is a string,
DynamoDBAction
writes non-JSON data to the DynamoDB table as binary data. The DynamoDB console displays the data as Base64-encoded text. ThepayloadField
is<payload-field>_raw
.- DynamoD
Bv2Action Defines an action to write to the Amazon DynamoDB table that you created. The default action payload contains all attribute-value pairs that have the information about the detector model instance and the event that triggered the action. You can also customize the payload. A separate column of the DynamoDB table receives one attribute-value pair in the payload that you specify.
The
type
value forPayload
must beJSON
.You can use expressions for parameters that are strings. For more information, see Expressions in the AWS IoT Events Developer Guide.
- Event
Specifies the
actions
to be performed when thecondition
evaluates to TRUE.- Firehose
Action Sends information about the detector model instance and the event that triggered the action to an Amazon Kinesis Data Firehose delivery stream.
- Input
Information about the input.
- Input
Configuration Information about the configuration of an input.
- Input
Definition The definition of the input.
- Input
Summary Information about the input.
- IotEvents
Action Sends an AWS IoT Events input, passing in information about the detector model instance and the event that triggered the action.
- IotEvents
Client - A client for the AWS IoT Events API.
- IotSite
Wise Action Sends information about the detector model instance and the event that triggered the action to a specified asset property in AWS IoT SiteWise.
You must specify either
propertyAlias
or bothassetId
andpropertyId
to identify the target asset property in AWS IoT SiteWise.For parameters that are string data type, you can specify the following options:
-
Use a string. For example, the
propertyAlias
value can be'/company/windfarm/3/turbine/7/temperature'
. -
Use an expression. For example, the
propertyAlias
value can be'company/windfarm/${$input.TemperatureInput.sensorData.windfarmID}/turbine/${$input.TemperatureInput.sensorData.turbineID}/temperature'
.For more information, see Expressions in the AWS IoT Events Developer Guide.
-
- IotTopic
Publish Action Information required to publish the MQTT message through the AWS IoT message broker.
- Lambda
Action Calls a Lambda function, passing in information about the detector model instance and the event that triggered the action.
- List
Detector Model Versions Request - List
Detector Model Versions Response - List
Detector Models Request - List
Detector Models Response - List
Inputs Request - List
Inputs Response - List
Tags ForResource Request - List
Tags ForResource Response - Logging
Options The values of the AWS IoT Events logging options.
- OnEnter
Lifecycle When entering this state, perform these
actions
if thecondition
is TRUE.- OnExit
Lifecycle When exiting this state, perform these
actions
if the specifiedcondition
isTRUE
.- OnInput
Lifecycle Specifies the actions performed when the
condition
evaluates to TRUE.- Payload
Information needed to configure the payload.
By default, AWS IoT Events generates a standard payload in JSON for any action. This action payload contains all attribute-value pairs that have the information about the detector model instance and the event triggered the action. To configure the action payload, you can use
contentExpression
.- PutLogging
Options Request - Reset
Timer Action Information required to reset the timer. The timer is reset to the previously evaluated result of the duration. The duration expression isn't reevaluated when you reset the timer.
- SNSTopic
Publish Action Information required to publish the Amazon SNS message.
- SetTimer
Action Information needed to set the timer.
- SetVariable
Action Information about the variable and its new value.
- SqsAction
Sends information about the detector model instance and the event that triggered the action to an Amazon SQS queue.
- State
Information that defines a state of a detector.
- Tag
Metadata that can be used to manage the resource.
- TagResource
Request - TagResource
Response - Transition
Event Specifies the actions performed and the next state entered when a
condition
evaluates to TRUE.- Untag
Resource Request - Untag
Resource Response - Update
Detector Model Request - Update
Detector Model Response - Update
Input Request - Update
Input Response
Enums§
- Create
Detector Model Error - Errors returned by CreateDetectorModel
- Create
Input Error - Errors returned by CreateInput
- Delete
Detector Model Error - Errors returned by DeleteDetectorModel
- Delete
Input Error - Errors returned by DeleteInput
- Describe
Detector Model Error - Errors returned by DescribeDetectorModel
- Describe
Input Error - Errors returned by DescribeInput
- Describe
Logging Options Error - Errors returned by DescribeLoggingOptions
- List
Detector Model Versions Error - Errors returned by ListDetectorModelVersions
- List
Detector Models Error - Errors returned by ListDetectorModels
- List
Inputs Error - Errors returned by ListInputs
- List
Tags ForResource Error - Errors returned by ListTagsForResource
- PutLogging
Options Error - Errors returned by PutLoggingOptions
- TagResource
Error - Errors returned by TagResource
- Untag
Resource Error - Errors returned by UntagResource
- Update
Detector Model Error - Errors returned by UpdateDetectorModel
- Update
Input Error - Errors returned by UpdateInput
Traits§
- IotEvents
- Trait representing the capabilities of the AWS IoT Events API. AWS IoT Events clients implement this trait.