Syntax Properties Return values Examples See also

AWS::IoTEvents::Input

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.

Syntax

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

JSON


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

YAML


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

Properties

InputDefinition

The definition of the input.

Required: Yes

Type: InputDefinition

Update requires: No interruption

InputDescription

A brief description of the input.

Required: No

Type: String

Minimum: 1

Maximum: 1024

Update requires: No interruption

InputName

The name of the input.

Required: No

Type: String

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

Minimum: 1

Maximum: 128

Update requires: Replacement

Tags

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

Ref

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.

Examples

Input

The following example creates an input.

JSON


{
  "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"
            }
          ]
        }
      }
    }
  }
}

YAML


---
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"