AWS::LookoutEquipment::InferenceScheduler - 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.

AWS::LookoutEquipment::InferenceScheduler

Creates a scheduled inference. Scheduling an inference is setting up a continuous real-time inference plan to analyze new measurement data. When setting up the schedule, you provide an Amazon S3 bucket location for the input data, assign it a delimiter between separate entries in the data, set an offset delay if desired, and set the frequency of inferencing. You must also provide an Amazon S3 bucket location for the output data.

Note

Updating some properties below (for example, InferenceSchedulerName and ServerSideKmsKeyId) triggers a resource replacement, which requires a new model. To replace such a property using Amazon CloudFormation, but without creating a completely new stack, you must replace ModelName. If you need to replace the property, but want to use the same model, delete the current stack and create a new one with the updated properties.

Syntax

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

JSON

{ "Type" : "AWS::LookoutEquipment::InferenceScheduler", "Properties" : { "DataDelayOffsetInMinutes" : Integer, "DataInputConfiguration" : Json, "DataOutputConfiguration" : Json, "DataUploadFrequency" : String, "InferenceSchedulerName" : String, "ModelName" : String, "RoleArn" : String, "ServerSideKmsKeyId" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::LookoutEquipment::InferenceScheduler Properties: DataDelayOffsetInMinutes: Integer DataInputConfiguration: Json DataOutputConfiguration: Json DataUploadFrequency: String InferenceSchedulerName: String ModelName: String RoleArn: String ServerSideKmsKeyId: String Tags: - Tag

Properties

DataDelayOffsetInMinutes

A period of time (in minutes) by which inference on the data is delayed after the data starts. For instance, if an offset delay time of five minutes was selected, inference will not begin on the data until the first data measurement after the five minute mark. For example, if five minutes is selected, the inference scheduler will wake up at the configured frequency with the additional five minute delay time to check the customer S3 bucket. The customer can upload data at the same frequency and they don't need to stop and restart the scheduler when uploading new data.

Required: No

Type: Integer

Update requires: No interruption

DataInputConfiguration

Specifies configuration information for the input data for the inference scheduler, including delimiter, format, and dataset location.

Required: Yes

Type: Json

Update requires: No interruption

DataOutputConfiguration

Specifies configuration information for the output results for the inference scheduler, including the Amazon S3 location for the output.

Required: Yes

Type: Json

Update requires: No interruption

DataUploadFrequency

How often data is uploaded to the source S3 bucket for the input data. This value is the length of time between data uploads. For instance, if you select 5 minutes, Amazon Lookout for Equipment will upload the real-time data to the source bucket once every 5 minutes. This frequency also determines how often Amazon Lookout for Equipment starts a scheduled inference on your data. In this example, it starts once every 5 minutes.

Required: Yes

Type: String

Allowed values: PT10M | PT15M | PT1H | PT30M | PT5M

Update requires: No interruption

InferenceSchedulerName

The name of the inference scheduler.

Required: No

Type: String

Minimum: 1

Maximum: 200

Pattern: ^[0-9a-zA-Z_-]{1,200}$

Update requires: Replacement

ModelName

The name of the ML model used for the inference scheduler.

Required: Yes

Type: String

Minimum: 1

Maximum: 200

Pattern: ^[0-9a-zA-Z_-]{1,200}$

Update requires: Replacement

RoleArn

The Amazon Resource Name (ARN) of a role with permission to access the data source being used for the inference.

Required: Yes

Type: String

Update requires: No interruption

ServerSideKmsKeyId

Provides the identifier of the Amazon KMS key used to encrypt inference scheduler data by Amazon Lookout for Equipment.

Required: No

Type: String

Update requires: Replacement

Tags

Any tags associated with the inference scheduler.

For more information, see Tag.

Required: No

Type: List of Tag

Update requires: No interruption

Return values

Fn::GetAtt

InferenceSchedulerArn

The Amazon Resource Name (ARN) of the inference scheduler being created.

Examples

Inference Scheduler

Creates a schedule inference

JSON

{ "AWSTemplateFormatVersion": "2010-09-09", "Parameters": { "Name": { "Type": "String" } }, "Resources": { "MyInferenceScheduler": { "Type": "AWS::LookoutEquipment::InferenceScheduler", "Properties": { "InferenceSchedulerName": {"Ref": "Name"}, "ModelName": "my-test-model", "DataUploadFrequency": "PT5M", "RoleArn": {"Fn::ImportValue": "MyExportRole"}, "DataInputConfiguration": { "S3InputConfiguration": { "Bucket": {"Fn::ImportValue":"MyExportBucket"}, "Prefix": "myTestData/" } }, "DataOutputConfiguration": { "S3OutputConfiguration": { "Bucket": {"Fn::ImportValue": "MyExportBucket"}, "Prefix": "myTestData/" } } } } }, "Outputs": { "PrimaryId": { "Value": { "Ref": "MyInferenceScheduler" } } } }

YAML

AWSTemplateFormatVersion: 2010-09-09 Parameters: Name: Type: String Resources: MyInferenceScheduler: Type: 'AWS::LookoutEquipment::InferenceScheduler' Properties: InferenceSchedulerName: !Ref Name ModelName: my-test-model DataUploadFrequency: PT5M RoleArn: !ImportValue MyExportRole DataInputConfiguration: S3InputConfiguration: Bucket: !ImportValue MyExportBucket Prefix: myTestData/ DataOutputConfiguration: S3OutputConfiguration: Bucket: !ImportValue MyExportBucket Prefix: myTestData/ Outputs: PrimaryId: Value: !Ref MyInferenceScheduler