AWS::IoTEvents::Input - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


The AWS::IoTEvents::Input resource creates an input. To monitor your devices and processes, they must have a way to get telemetry data into Amazon IoT Events. This is done by sending messages as inputs to Amazon IoT Events. For more information, see How to Use Amazon IoT Events in the Amazon IoT Events Developer Guide.


To declare this entity in your Amazon CloudFormation template, use the following syntax:


{ "Type" : "AWS::IoTEvents::Input", "Properties" : { "InputDefinition" : InputDefinition, "InputDescription" : String, "InputName" : String, "Tags" : [ Tag, ... ] } }


Type: AWS::IoTEvents::Input Properties: InputDefinition: InputDefinition InputDescription: String InputName: String Tags: - Tag



The definition of the input.

Required: Yes

Type: InputDefinition

Update requires: No interruption


A brief description of the input.

Required: No

Type: String

Minimum: 1

Maximum: 1024

Update requires: No interruption


The name of the input.

Required: No

Type: String

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*$

Minimum: 1

Maximum: 128

Update requires: Replacement


An array of key-value pairs to apply to this resource.

For more information, see Tag.

Required: No

Type: Array of Tag

Update requires: No interruption

Return values


When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the name of the input. For example:

{"Ref": "myInput"}

For the Amazon IoT Events input myInput, Ref returns the name of the input.

For more information about using the Ref function, see Ref.



The following example creates an input.


{ "Description": "Input Template for CloudFormation", "Resources": { "myInput": { "Type": "AWS::IoTEvents::Input", "Properties": { "InputName": "myInput", "InputDescription": "My Input created by CloudFormation", "InputDefinition": { "Attributes": [ { "JsonPath": "foo" }, { "JsonPath": "bar" } ] } } } } }


--- Description: "Input Template for CloudFormation" Resources: myInput: Type: "AWS::IoTEvents::Input" Properties: InputName: "myInput" InputDescription: "My Input created by CloudFormation" InputDefinition: Attributes: - JsonPath: "foo" - JsonPath: "bar"

See also