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§
- Acknowledge
Flow Specifies whether to get notified for alarm state changes.
- Action
An action to be performed when the
conditionis TRUE.- Alarm
Action Specifies one of the following actions to receive notifications when the alarm state changes.
- Alarm
Capabilities Contains the configuration information of alarm state changes.
- Alarm
Event Actions Contains information about one or more alarm actions.
- Alarm
Model Summary Contains a summary of an alarm model.
- Alarm
Model Version Summary Contains a summary of an alarm model version.
- Alarm
Notification Contains information about one or more notification actions.
- Alarm
Rule Defines when your alarm is invoked.
- Analysis
Result Contains the result of the analysis.
- Analysis
Result Location Contains information that you can use to locate the field in your detector model that the analysis result references.
- Asset
Property Timestamp A structure that contains timestamp information. For more information, see TimeInNanos in the AWS IoT SiteWise API Reference.
You must use expressions for all parameters in
AssetPropertyTimestamp. The expressions accept literals, operators, functions, references, and substitution templates.Examples
-
For literal values, the expressions must contain single quotes. For example, the value for the
timeInSecondsparameter can be'1586400675'. -
For references, you must specify either variables or input values. For example, the value for the
offsetInNanosparameter can be$variable.time. -
For a substitution template, you must use
${}, and the template must be in single quotes. A substitution template can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
timeInSecondsparameter uses a substitution template.'${$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.
You must use expressions for all parameters in
AssetPropertyValue. The expressions accept literals, operators, functions, references, and substitution templates.Examples
-
For literal values, the expressions must contain single quotes. For example, the value for the
qualityparameter can be'GOOD'. -
For references, you must specify either variables or input values. For example, the value for the
qualityparameter 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 use expressions for all parameters in
AssetPropertyVariant. The expressions accept literals, operators, functions, references, and substitution templates.Examples
-
For literal values, the expressions must contain single quotes. For example, the value for the
integerValueparameter can be'100'. -
For references, you must specify either variables or parameters. For example, the value for the
booleanValueparameter can be$variable.offline. -
For a substitution template, you must use
${}, and the template must be in single quotes. A substitution template can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
doubleValueparameter uses a substitution template.'${$input.TemperatureInput.sensorData.temperature * 6 / 5 + 32}'
For more information, see Expressions in the AWS IoT Events Developer Guide.
You must specify one of the following value types, depending on the
dataTypeof the specified asset property. For more information, see AssetProperty in the AWS IoT SiteWise API Reference.-
- 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 theconditionexpressions used by detectors.- Clear
Timer Action Information needed to clear the timer.
- Create
Alarm Model Request - Create
Alarm Model Response - Create
Detector Model Request - Create
Detector Model Response - Create
Input Request - Create
Input Response - Delete
Alarm Model Request - Delete
Alarm Model Response - Delete
Detector Model Request - Delete
Detector Model Response - Delete
Input Request - Delete
Input Response - Describe
Alarm Model Request - Describe
Alarm Model Response - Describe
Detector Model Analysis Request - Describe
Detector Model Analysis 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 the information about the detector model instance and the event that triggered the action. You can customize the payload. One column of the DynamoDB table receives all attribute-value pairs in the payload that you specify.
You must use expressions for all parameters in
DynamoDBAction. The expressions accept literals, operators, functions, references, and substitution templates.Examples
-
For literal values, the expressions must contain single quotes. For example, the value for the
hashKeyTypeparameter can be'STRING'. -
For references, you must specify either variables or input values. For example, the value for the
hashKeyFieldparameter can be$input.GreenhouseInput.name. -
For a substitution template, you must use
${}, and the template must be in single quotes. A substitution template can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
hashKeyValueparameter uses a substitution template.'${$input.GreenhouseInput.temperature * 6 / 5 + 32} in Fahrenheit' -
For a string concatenation, you must use
+. A string concatenation can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
tableNameparameter uses a string concatenation.'GreenhouseTemperatureTable ' + $input.GreenhouseInput.date
For more information, see Expressions in the AWS IoT Events Developer Guide.
If the defined payload type is a string,
DynamoDBActionwrites non-JSON data to the DynamoDB table as binary data. The DynamoDB console displays the data as Base64-encoded text. The value for thepayloadFieldparameter 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 the information about the detector model instance and the event that triggered the action. You can customize the payload. A separate column of the DynamoDB table receives one attribute-value pair in the payload that you specify.
You must use expressions for all parameters in
DynamoDBv2Action. The expressions accept literals, operators, functions, references, and substitution templates.Examples
-
For literal values, the expressions must contain single quotes. For example, the value for the
tableNameparameter can be'GreenhouseTemperatureTable'. -
For references, you must specify either variables or input values. For example, the value for the
tableNameparameter can be$variable.ddbtableName. -
For a substitution template, you must use
${}, and the template must be in single quotes. A substitution template can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
contentExpressionparameter inPayloaduses a substitution template.'{\"sensorID\": \"${$input.GreenhouseInput.sensor_id}\", \"temperature\": \"${$input.GreenhouseInput.temperature * 9 / 5 + 32}\"}' -
For a string concatenation, you must use
+. A string concatenation can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
tableNameparameter uses a string concatenation.'GreenhouseTemperatureTable ' + $input.GreenhouseInput.date
For more information, see Expressions in the AWS IoT Events Developer Guide.
The value for the
typeparameter inPayloadmust beJSON.-
- Email
Configuration Contains the configuration information of email notifications.
- Email
Content Contains the subject and message of an email.
- Email
Recipients Contains the information of one or more recipients who receive the emails.
You must add the users that receive emails to your AWS SSO store.
- Event
Specifies the
actionsto be performed when theconditionevaluates 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.
- GetDetector
Model Analysis Results Request - GetDetector
Model Analysis Results Response - Initialization
Configuration Specifies the default alarm state. The configuration applies to all alarms that were created based on this alarm model.
- Input
Information about the input.
- Input
Configuration Information about the configuration of an input.
- Input
Definition The definition of the input.
- Input
Identifier The identifer 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.
- IotEvents
Input Identifier The identifier of the input routed to AWS IoT Events.
- 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 use expressions for all parameters in
IotSiteWiseAction. The expressions accept literals, operators, functions, references, and substitutions templates.Examples
-
For literal values, the expressions must contain single quotes. For example, the value for the
propertyAliasparameter can be'/company/windfarm/3/turbine/7/temperature'. -
For references, you must specify either variables or input values. For example, the value for the
assetIdparameter can be$input.TurbineInput.assetId1. -
For a substitution template, you must use
${}, and the template must be in single quotes. A substitution template can also contain a combination of literals, operators, functions, references, and substitution templates.In the following example, the value for the
propertyAliasparameter uses a substitution template.'company/windfarm/${$input.TemperatureInput.sensorData.windfarmID}/turbine/ ${$input.TemperatureInput.sensorData.turbineID}/temperature'
You must specify either
propertyAliasor bothassetIdandpropertyIdto identify the target asset property in AWS IoT SiteWise.For more information, see Expressions in the AWS IoT Events Developer Guide.
-
- IotSite
Wise Asset Model Property Identifier The asset model property identifer of the input routed from AWS IoT SiteWise.
- IotSite
Wise Input Identifier The identifer of the input routed from AWS IoT SiteWise.
- 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
Alarm Model Versions Request - List
Alarm Model Versions Response - List
Alarm Models Request - List
Alarm Models Response - List
Detector Model Versions Request - List
Detector Model Versions Response - List
Detector Models Request - List
Detector Models Response - List
Input Routings Request - List
Input Routings 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.
- Notification
Action Contains the notification settings of an alarm model. The settings apply to all alarms that were created based on this alarm model.
- Notification
Target Actions Specifies an AWS Lambda function to manage alarm notifications. You can create one or use the AWS Lambda function provided by AWS IoT Events.
- OnEnter
Lifecycle When entering this state, perform these
actionsif theconditionis TRUE.- OnExit
Lifecycle When exiting this state, perform these
actionsif the specifiedconditionisTRUE.- OnInput
Lifecycle Specifies the actions performed when the
conditionevaluates 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 - Recipient
Detail The information that identifies the recipient.
- 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.
- Routed
Resource Contains information about the routed resource.
- SMSConfiguration
Contains the configuration information of SMS notifications.
- SNSTopic
Publish Action Information required to publish the Amazon SNS message.
- SSOIdentity
Contains information about your identity source in AWS Single Sign-On. For more information, see the AWS Single Sign-On User Guide.
- SetTimer
Action Information needed to set the timer.
- SetVariable
Action Information about the variable and its new value.
- Simple
Rule A rule that compares an input property value to a threshold value with a comparison operator.
- SqsAction
Sends information about the detector model instance and the event that triggered the action to an Amazon SQS queue.
- Start
Detector Model Analysis Request - Start
Detector Model Analysis Response - 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
conditionevaluates to TRUE.- Untag
Resource Request - Untag
Resource Response - Update
Alarm Model Request - Update
Alarm Model Response - Update
Detector Model Request - Update
Detector Model Response - Update
Input Request - Update
Input Response
Enums§
- Create
Alarm Model Error - Errors returned by CreateAlarmModel
- Create
Detector Model Error - Errors returned by CreateDetectorModel
- Create
Input Error - Errors returned by CreateInput
- Delete
Alarm Model Error - Errors returned by DeleteAlarmModel
- Delete
Detector Model Error - Errors returned by DeleteDetectorModel
- Delete
Input Error - Errors returned by DeleteInput
- Describe
Alarm Model Error - Errors returned by DescribeAlarmModel
- Describe
Detector Model Analysis Error - Errors returned by DescribeDetectorModelAnalysis
- Describe
Detector Model Error - Errors returned by DescribeDetectorModel
- Describe
Input Error - Errors returned by DescribeInput
- Describe
Logging Options Error - Errors returned by DescribeLoggingOptions
- GetDetector
Model Analysis Results Error - Errors returned by GetDetectorModelAnalysisResults
- List
Alarm Model Versions Error - Errors returned by ListAlarmModelVersions
- List
Alarm Models Error - Errors returned by ListAlarmModels
- List
Detector Model Versions Error - Errors returned by ListDetectorModelVersions
- List
Detector Models Error - Errors returned by ListDetectorModels
- List
Input Routings Error - Errors returned by ListInputRoutings
- List
Inputs Error - Errors returned by ListInputs
- List
Tags ForResource Error - Errors returned by ListTagsForResource
- PutLogging
Options Error - Errors returned by PutLoggingOptions
- Start
Detector Model Analysis Error - Errors returned by StartDetectorModelAnalysis
- TagResource
Error - Errors returned by TagResource
- Untag
Resource Error - Errors returned by UntagResource
- Update
Alarm Model Error - Errors returned by UpdateAlarmModel
- 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.