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

Maximum: 128

Update requires: No interruption

InputName

The name of the input.

Required: No

Type: String

Minimum: 1

Maximum: 128

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

Update requires: Replacement

Tags

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

For more information, see Tag.

Required: No

Type: List of Tag

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns 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 Reffunction, 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"