AWS SDK for PHP 3.x

Client: Aws\IoTEventsData\IoTEventsDataClient

Service ID: iotevents-data

Version: 2018-10-23

This page describes the parameters and results for the operations of the AWS IoT Events Data (2018-10-23), and shows how to use the Aws\IoTEventsData\IoTEventsDataClient object to call the described operations. This documentation is specific to the 2018-10-23 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

BatchAcknowledgeAlarm ( array $params = [] )
Acknowledges one or more alarms.
BatchDeleteDetector ( array $params = [] )
Deletes one or more detectors that were created.
BatchDisableAlarm ( array $params = [] )
Disables one or more alarms.
BatchEnableAlarm ( array $params = [] )
Enables one or more alarms.
BatchPutMessage ( array $params = [] )
Sends a set of messages to the IoT Events system.
BatchResetAlarm ( array $params = [] )
Resets one or more alarms.
BatchSnoozeAlarm ( array $params = [] )
Changes one or more alarms to the snooze mode.
BatchUpdateDetector ( array $params = [] )
Updates the state, variable values, and timer settings of one or more detectors (instances) of a specified detector model.
DescribeAlarm ( array $params = [] )
Retrieves information about an alarm.
DescribeDetector ( array $params = [] )
Returns information about the specified detector (instance).
ListAlarms ( array $params = [] )
Lists one or more alarms.
ListDetectors ( array $params = [] )
Lists detectors (the instances of a detector model).

Operations

BatchAcknowledgeAlarm

$result = $client->batchAcknowledgeAlarm([/* ... */]);
$promise = $client->batchAcknowledgeAlarmAsync([/* ... */]);

Acknowledges one or more alarms. The alarms change to the ACKNOWLEDGED state after you acknowledge them.

Parameter Syntax

$result = $client->batchAcknowledgeAlarm([
    'acknowledgeActionRequests' => [ // REQUIRED
        [
            'alarmModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'note' => '<string>',
            'requestId' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members

acknowledgeActionRequests

Required: Yes
Type: Array of AcknowledgeAlarmActionRequest structures

The list of acknowledge action requests. You can specify up to 10 requests per operation.

Result Syntax

[
    'errorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'requestId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

errorEntries

Type: Array of BatchAlarmActionErrorEntry structures

A list of errors associated with the request, or null if there are no errors. Each error entry contains an entry ID that helps you identify the entry that failed.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchDeleteDetector

$result = $client->batchDeleteDetector([/* ... */]);
$promise = $client->batchDeleteDetectorAsync([/* ... */]);

Deletes one or more detectors that were created. When a detector is deleted, its state will be cleared and the detector will be removed from the list of detectors. The deleted detector will no longer appear if referenced in the ListDetectors API call.

Parameter Syntax

$result = $client->batchDeleteDetector([
    'detectors' => [ // REQUIRED
        [
            'detectorModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'messageId' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members

detectors

Required: Yes
Type: Array of DeleteDetectorRequest structures

The list of one or more detectors to be deleted.

Result Syntax

[
    'batchDeleteDetectorErrorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'messageId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

batchDeleteDetectorErrorEntries

Type: Array of BatchDeleteDetectorErrorEntry structures

A list of errors associated with the request, or an empty array ([]) if there are no errors. Each error entry contains a messageId that helps you identify the entry that failed.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchDisableAlarm

$result = $client->batchDisableAlarm([/* ... */]);
$promise = $client->batchDisableAlarmAsync([/* ... */]);

Disables one or more alarms. The alarms change to the DISABLED state after you disable them.

Parameter Syntax

$result = $client->batchDisableAlarm([
    'disableActionRequests' => [ // REQUIRED
        [
            'alarmModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'note' => '<string>',
            'requestId' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members

disableActionRequests

Required: Yes
Type: Array of DisableAlarmActionRequest structures

The list of disable action requests. You can specify up to 10 requests per operation.

Result Syntax

[
    'errorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'requestId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

errorEntries

Type: Array of BatchAlarmActionErrorEntry structures

A list of errors associated with the request, or null if there are no errors. Each error entry contains an entry ID that helps you identify the entry that failed.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchEnableAlarm

$result = $client->batchEnableAlarm([/* ... */]);
$promise = $client->batchEnableAlarmAsync([/* ... */]);

Enables one or more alarms. The alarms change to the NORMAL state after you enable them.

Parameter Syntax

$result = $client->batchEnableAlarm([
    'enableActionRequests' => [ // REQUIRED
        [
            'alarmModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'note' => '<string>',
            'requestId' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members

enableActionRequests

Required: Yes
Type: Array of EnableAlarmActionRequest structures

The list of enable action requests. You can specify up to 10 requests per operation.

Result Syntax

[
    'errorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'requestId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

errorEntries

Type: Array of BatchAlarmActionErrorEntry structures

A list of errors associated with the request, or null if there are no errors. Each error entry contains an entry ID that helps you identify the entry that failed.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchPutMessage

$result = $client->batchPutMessage([/* ... */]);
$promise = $client->batchPutMessageAsync([/* ... */]);

Sends a set of messages to the IoT Events system. Each message payload is transformed into the input you specify ("inputName") and ingested into any detectors that monitor that input. If multiple messages are sent, the order in which the messages are processed isn't guaranteed. To guarantee ordering, you must send messages one at a time and wait for a successful response.

Parameter Syntax

$result = $client->batchPutMessage([
    'messages' => [ // REQUIRED
        [
            'inputName' => '<string>', // REQUIRED
            'messageId' => '<string>', // REQUIRED
            'payload' => <string || resource || Psr\Http\Message\StreamInterface>, // REQUIRED
            'timestamp' => [
                'timeInMillis' => <integer>,
            ],
        ],
        // ...
    ],
]);

Parameter Details

Members

messages

Required: Yes
Type: Array of Message structures

The list of messages to send. Each message has the following format: '{ "messageId": "string", "inputName": "string", "payload": "string"}'

Result Syntax

[
    'BatchPutMessageErrorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'messageId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

BatchPutMessageErrorEntries

Type: Array of BatchPutMessageErrorEntry structures

A list of any errors encountered when sending the messages.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchResetAlarm

$result = $client->batchResetAlarm([/* ... */]);
$promise = $client->batchResetAlarmAsync([/* ... */]);

Resets one or more alarms. The alarms return to the NORMAL state after you reset them.

Parameter Syntax

$result = $client->batchResetAlarm([
    'resetActionRequests' => [ // REQUIRED
        [
            'alarmModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'note' => '<string>',
            'requestId' => '<string>', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members

resetActionRequests

Required: Yes
Type: Array of ResetAlarmActionRequest structures

The list of reset action requests. You can specify up to 10 requests per operation.

Result Syntax

[
    'errorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'requestId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

errorEntries

Type: Array of BatchAlarmActionErrorEntry structures

A list of errors associated with the request, or null if there are no errors. Each error entry contains an entry ID that helps you identify the entry that failed.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchSnoozeAlarm

$result = $client->batchSnoozeAlarm([/* ... */]);
$promise = $client->batchSnoozeAlarmAsync([/* ... */]);

Changes one or more alarms to the snooze mode. The alarms change to the SNOOZE_DISABLED state after you set them to the snooze mode.

Parameter Syntax

$result = $client->batchSnoozeAlarm([
    'snoozeActionRequests' => [ // REQUIRED
        [
            'alarmModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'note' => '<string>',
            'requestId' => '<string>', // REQUIRED
            'snoozeDuration' => <integer>, // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members

snoozeActionRequests

Required: Yes
Type: Array of SnoozeAlarmActionRequest structures

The list of snooze action requests. You can specify up to 10 requests per operation.

Result Syntax

[
    'errorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'requestId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

errorEntries

Type: Array of BatchAlarmActionErrorEntry structures

A list of errors associated with the request, or null if there are no errors. Each error entry contains an entry ID that helps you identify the entry that failed.

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

BatchUpdateDetector

$result = $client->batchUpdateDetector([/* ... */]);
$promise = $client->batchUpdateDetectorAsync([/* ... */]);

Updates the state, variable values, and timer settings of one or more detectors (instances) of a specified detector model.

Parameter Syntax

$result = $client->batchUpdateDetector([
    'detectors' => [ // REQUIRED
        [
            'detectorModelName' => '<string>', // REQUIRED
            'keyValue' => '<string>',
            'messageId' => '<string>', // REQUIRED
            'state' => [ // REQUIRED
                'stateName' => '<string>', // REQUIRED
                'timers' => [ // REQUIRED
                    [
                        'name' => '<string>', // REQUIRED
                        'seconds' => <integer>, // REQUIRED
                    ],
                    // ...
                ],
                'variables' => [ // REQUIRED
                    [
                        'name' => '<string>', // REQUIRED
                        'value' => '<string>', // REQUIRED
                    ],
                    // ...
                ],
            ],
        ],
        // ...
    ],
]);

Parameter Details

Members

detectors

Required: Yes
Type: Array of UpdateDetectorRequest structures

The list of detectors (instances) to update, along with the values to update.

Result Syntax

[
    'batchUpdateDetectorErrorEntries' => [
        [
            'errorCode' => 'ResourceNotFoundException|InvalidRequestException|InternalFailureException|ServiceUnavailableException|ThrottlingException',
            'errorMessage' => '<string>',
            'messageId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members

batchUpdateDetectorErrorEntries

Type: Array of BatchUpdateDetectorErrorEntry structures

A list of those detector updates that resulted in errors. (If an error is listed here, the specific update did not occur.)

Errors

InvalidRequestException:
The request was invalid.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.
ThrottlingException:
The request could not be completed due to throttling.

DescribeAlarm

$result = $client->describeAlarm([/* ... */]);
$promise = $client->describeAlarmAsync([/* ... */]);

Retrieves information about an alarm.

Parameter Syntax

$result = $client->describeAlarm([
    'alarmModelName' => '<string>', // REQUIRED
    'keyValue' => '<string>',
]);

Parameter Details

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

Result Syntax

[
    'alarm' => [
        'alarmModelName' => '<string>',
        'alarmModelVersion' => '<string>',
        'alarmState' => [
            'customerAction' => [
                'acknowledgeActionConfiguration' => [
                    'note' => '<string>',
                ],
                'actionName' => 'SNOOZE|ENABLE|DISABLE|ACKNOWLEDGE|RESET',
                'disableActionConfiguration' => [
                    'note' => '<string>',
                ],
                'enableActionConfiguration' => [
                    'note' => '<string>',
                ],
                'resetActionConfiguration' => [
                    'note' => '<string>',
                ],
                'snoozeActionConfiguration' => [
                    'note' => '<string>',
                    'snoozeDuration' => <integer>,
                ],
            ],
            'ruleEvaluation' => [
                'simpleRuleEvaluation' => [
                    'inputPropertyValue' => '<string>',
                    'operator' => 'GREATER|GREATER_OR_EQUAL|LESS|LESS_OR_EQUAL|EQUAL|NOT_EQUAL',
                    'thresholdValue' => '<string>',
                ],
            ],
            'stateName' => 'DISABLED|NORMAL|ACTIVE|ACKNOWLEDGED|SNOOZE_DISABLED|LATCHED',
            'systemEvent' => [
                'eventType' => 'STATE_CHANGE',
                'stateChangeConfiguration' => [
                    'triggerType' => 'SNOOZE_TIMEOUT',
                ],
            ],
        ],
        'creationTime' => <DateTime>,
        'keyValue' => '<string>',
        'lastUpdateTime' => <DateTime>,
        'severity' => <integer>,
    ],
]

Result Details

Members

alarm

Type: Alarm structure

Contains information about an alarm.

Errors

InvalidRequestException:
The request was invalid.
ResourceNotFoundException:
The resource was not found.
ThrottlingException:
The request could not be completed due to throttling.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.

DescribeDetector

$result = $client->describeDetector([/* ... */]);
$promise = $client->describeDetectorAsync([/* ... */]);

Returns information about the specified detector (instance).

Parameter Syntax

$result = $client->describeDetector([
    'detectorModelName' => '<string>', // REQUIRED
    'keyValue' => '<string>',
]);

Parameter Details

Members

detectorModelName

Required: Yes
Type: string

The name of the detector model whose detectors (instances) you want information about.

keyValue

Type: string

A filter used to limit results to detectors (instances) created because of the given key ID.

Result Syntax

[
    'detector' => [
        'creationTime' => <DateTime>,
        'detectorModelName' => '<string>',
        'detectorModelVersion' => '<string>',
        'keyValue' => '<string>',
        'lastUpdateTime' => <DateTime>,
        'state' => [
            'stateName' => '<string>',
            'timers' => [
                [
                    'name' => '<string>',
                    'timestamp' => <DateTime>,
                ],
                // ...
            ],
            'variables' => [
                [
                    'name' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
        ],
    ],
]

Result Details

Members

detector

Type: Detector structure

Information about the detector (instance).

Errors

InvalidRequestException:
The request was invalid.
ResourceNotFoundException:
The resource was not found.
ThrottlingException:
The request could not be completed due to throttling.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.

ListAlarms

$result = $client->listAlarms([/* ... */]);
$promise = $client->listAlarmsAsync([/* ... */]);

Lists one or more alarms. The operation returns only the metadata associated with each alarm.

Parameter Syntax

$result = $client->listAlarms([
    'alarmModelName' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

maxResults

Type: int

The maximum number of results to be returned per request.

nextToken

Type: string

The token that you can use to return the next set of results.

Result Syntax

[
    'alarmSummaries' => [
        [
            'alarmModelName' => '<string>',
            'alarmModelVersion' => '<string>',
            'creationTime' => <DateTime>,
            'keyValue' => '<string>',
            'lastUpdateTime' => <DateTime>,
            'stateName' => 'DISABLED|NORMAL|ACTIVE|ACKNOWLEDGED|SNOOZE_DISABLED|LATCHED',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members

alarmSummaries

Type: Array of AlarmSummary structures

A list that summarizes each alarm.

nextToken

Type: string

The token that you can use to return the next set of results, or null if there are no more results.

Errors

InvalidRequestException:
The request was invalid.
ResourceNotFoundException:
The resource was not found.
ThrottlingException:
The request could not be completed due to throttling.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.

ListDetectors

$result = $client->listDetectors([/* ... */]);
$promise = $client->listDetectorsAsync([/* ... */]);

Lists detectors (the instances of a detector model).

Parameter Syntax

$result = $client->listDetectors([
    'detectorModelName' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'stateName' => '<string>',
]);

Parameter Details

Members

detectorModelName

Required: Yes
Type: string

The name of the detector model whose detectors (instances) are listed.

maxResults

Type: int

The maximum number of results to be returned per request.

nextToken

Type: string

The token that you can use to return the next set of results.

stateName

Type: string

A filter that limits results to those detectors (instances) in the given state.

Result Syntax

[
    'detectorSummaries' => [
        [
            'creationTime' => <DateTime>,
            'detectorModelName' => '<string>',
            'detectorModelVersion' => '<string>',
            'keyValue' => '<string>',
            'lastUpdateTime' => <DateTime>,
            'state' => [
                'stateName' => '<string>',
            ],
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members

detectorSummaries

Type: Array of DetectorSummary structures

A list of summary information about the detectors (instances).

nextToken

Type: string

The token that you can use to return the next set of results, or null if there are no more results.

Errors

InvalidRequestException:
The request was invalid.
ResourceNotFoundException:
The resource was not found.
ThrottlingException:
The request could not be completed due to throttling.
InternalFailureException:
An internal failure occurred.
ServiceUnavailableException:
The service is currently unavailable.

Shapes

AcknowledgeActionConfiguration

Description

Contains the configuration information of an acknowledge action.

Members

note

Type: string

The note that you can leave when you acknowledge the alarm.

AcknowledgeAlarmActionRequest

Description

Information needed to acknowledge the alarm.

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

note

Type: string

The note that you can leave when you acknowledge the alarm.

requestId

Required: Yes
Type: string

The request ID. Each ID must be unique within each batch.

Alarm

Description

Contains information about an alarm.

Members

alarmModelName

Type: string

The name of the alarm model.

alarmModelVersion

Type: string

The version of the alarm model.

alarmState

Type: AlarmState structure

Contains information about the current state of the alarm.

creationTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the alarm was created, in the Unix epoch format.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

lastUpdateTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the alarm was last updated, in the Unix epoch format.

severity

Type: int

A non-negative integer that reflects the severity level of the alarm.

AlarmState

Description

Contains information about the current state of the alarm.

Members

customerAction

Type: CustomerAction structure

Contains information about the action that you can take to respond to the alarm.

ruleEvaluation

Type: RuleEvaluation structure

Information needed to evaluate data.

stateName

Type: string

The name of the alarm state. The state name can be one of the following values:

DISABLED - When the alarm is in the DISABLED state, it isn't ready to evaluate data. To enable the alarm, you must change the alarm to the NORMAL state.
NORMAL - When the alarm is in the NORMAL state, it's ready to evaluate data.
ACTIVE - If the alarm is in the ACTIVE state, the alarm is invoked.
ACKNOWLEDGED - When the alarm is in the ACKNOWLEDGED state, the alarm was invoked and you acknowledged the alarm.
SNOOZE_DISABLED - When the alarm is in the SNOOZE_DISABLED state, the alarm is disabled for a specified period of time. After the snooze time, the alarm automatically changes to the NORMAL state.
LATCHED - When the alarm is in the LATCHED state, the alarm was invoked. However, the data that the alarm is currently evaluating is within the specified range. To change the alarm to the NORMAL state, you must acknowledge the alarm.

systemEvent

Type: SystemEvent structure

Contains information about alarm state changes.

AlarmSummary

Description

Contains a summary of an alarm.

Members

alarmModelName

Type: string

The name of the alarm model.

alarmModelVersion

Type: string

The version of the alarm model.

creationTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the alarm was created, in the Unix epoch format.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

lastUpdateTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the alarm was last updated, in the Unix epoch format.

stateName

Type: string

The name of the alarm state. The state name can be one of the following values:

DISABLED - When the alarm is in the DISABLED state, it isn't ready to evaluate data. To enable the alarm, you must change the alarm to the NORMAL state.
NORMAL - When the alarm is in the NORMAL state, it's ready to evaluate data.
ACTIVE - If the alarm is in the ACTIVE state, the alarm is invoked.
ACKNOWLEDGED - When the alarm is in the ACKNOWLEDGED state, the alarm was invoked and you acknowledged the alarm.
SNOOZE_DISABLED - When the alarm is in the SNOOZE_DISABLED state, the alarm is disabled for a specified period of time. After the snooze time, the alarm automatically changes to the NORMAL state.
LATCHED - When the alarm is in the LATCHED state, the alarm was invoked. However, the data that the alarm is currently evaluating is within the specified range. To change the alarm to the NORMAL state, you must acknowledge the alarm.

BatchAlarmActionErrorEntry

Description

Contains error messages associated with one of the following requests:

Members

errorCode

Type: string

The error code.

errorMessage

Type: string

A message that describes the error.

requestId

Type: string

The request ID. Each ID must be unique within each batch.

BatchDeleteDetectorErrorEntry

Description

Contains error messages associated with the deletion request.

Members

errorCode

Type: string

The error code.

errorMessage

Type: string

A message that describes the error.

messageId

Type: string

The ID of the message that caused the error. (See the value of the "messageId" in the detectors object of the DeleteDetectorRequest.)

BatchPutMessageErrorEntry

Description

Contains information about the errors encountered.

Members

errorCode

Type: string

The error code.

errorMessage

Type: string

A message that describes the error.

messageId

Type: string

The ID of the message that caused the error. (See the value corresponding to the "messageId" key in the "message" object.)

BatchUpdateDetectorErrorEntry

Description

Information about the error that occurred when attempting to update a detector.

Members

errorCode

Type: string

The error code.

errorMessage

Type: string

A message that describes the error.

messageId

Type: string

The "messageId" of the update request that caused the error. (The value of the "messageId" in the update request "Detector" object.)

CustomerAction

Description

Contains information about the action that you can take to respond to the alarm.

Members

acknowledgeActionConfiguration

Type: AcknowledgeActionConfiguration structure

Contains the configuration information of an acknowledge action.

actionName

Type: string

The name of the action. The action name can be one of the following values:

SNOOZE - When you snooze the alarm, the alarm state changes to SNOOZE_DISABLED.
ENABLE - When you enable the alarm, the alarm state changes to NORMAL.
DISABLE - When you disable the alarm, the alarm state changes to DISABLED.
ACKNOWLEDGE - When you acknowledge the alarm, the alarm state changes to ACKNOWLEDGED.
RESET - When you reset the alarm, the alarm state changes to NORMAL.

For more information, see the AlarmState API.

disableActionConfiguration

Type: DisableActionConfiguration structure

Contains the configuration information of a disable action.

enableActionConfiguration

Type: EnableActionConfiguration structure

Contains the configuration information of an enable action.

resetActionConfiguration

Type: ResetActionConfiguration structure

Contains the configuration information of a reset action.

snoozeActionConfiguration

Type: SnoozeActionConfiguration structure

Contains the configuration information of a snooze action.

DeleteDetectorRequest

Description

Information used to delete the detector model.

Members

detectorModelName

Required: Yes
Type: string

The name of the detector model that was used to create the detector instance.

keyValue

Type: string

The value of the key used to identify the detector.

messageId

Required: Yes
Type: string

The ID to assign to the DeleteDetectorRequest. Each "messageId" must be unique within each batch sent.

Detector

Description

Information about the detector (instance).

Members

creationTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the detector (instance) was created.

detectorModelName

Type: string

The name of the detector model that created this detector (instance).

detectorModelVersion

Type: string

The version of the detector model that created this detector (instance).

keyValue

Type: string

The value of the key (identifying the device or system) that caused the creation of this detector (instance).

lastUpdateTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the detector (instance) was last updated.

state

Type: DetectorState structure

The current state of the detector (instance).

DetectorState

Description

Information about the current state of the detector instance.

Members

stateName

Required: Yes
Type: string

The name of the state.

timers

Required: Yes
Type: Array of Timer structures

The current state of the detector's timers.

variables

Required: Yes
Type: Array of Variable structures

The current values of the detector's variables.

DetectorStateDefinition

Description

The new state, variable values, and timer settings of the detector (instance).

Members

stateName

Required: Yes
Type: string

The name of the new state of the detector (instance).

timers

Required: Yes
Type: Array of TimerDefinition structures

The new values of the detector's timers. Any timer whose value isn't specified is cleared, and its timeout event won't occur.

variables

Required: Yes
Type: Array of VariableDefinition structures

The new values of the detector's variables. Any variable whose value isn't specified is cleared.

DetectorStateSummary

Description

Information about the detector state.

Members

stateName

Type: string

The name of the state.

DetectorSummary

Description

Information about the detector (instance).

Members

creationTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the detector (instance) was created.

detectorModelName

Type: string

The name of the detector model that created this detector (instance).

detectorModelVersion

Type: string

The version of the detector model that created this detector (instance).

keyValue

Type: string

The value of the key (identifying the device or system) that caused the creation of this detector (instance).

lastUpdateTime

Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the detector (instance) was last updated.

state

Type: DetectorStateSummary structure

The current state of the detector (instance).

DisableActionConfiguration

Description

Contains the configuration information of a disable action.

Members

note

Type: string

The note that you can leave when you disable the alarm.

DisableAlarmActionRequest

Description

Information used to disable the alarm.

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

note

Type: string

The note that you can leave when you disable the alarm.

requestId

Required: Yes
Type: string

The request ID. Each ID must be unique within each batch.

EnableActionConfiguration

Description

Contains the configuration information of an enable action.

Members

note

Type: string

The note that you can leave when you enable the alarm.

EnableAlarmActionRequest

Description

Information needed to enable the alarm.

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

note

Type: string

The note that you can leave when you enable the alarm.

requestId

Required: Yes
Type: string

The request ID. Each ID must be unique within each batch.

InternalFailureException

Description

An internal failure occurred.

Members

message

Type: string

The message for the exception.

InvalidRequestException

Description

The request was invalid.

Members

message

Type: string

The message for the exception.

Message

Description

Information about a message.

Members

inputName

Required: Yes
Type: string

The name of the input into which the message payload is transformed.

messageId

Required: Yes
Type: string

The ID to assign to the message. Within each batch sent, each "messageId" must be unique.

payload

Required: Yes
Type: blob (string|resource|Psr\Http\Message\StreamInterface)

The payload of the message. This can be a JSON string or a Base-64-encoded string representing binary data (in which case you must decode it).

timestamp

Type: TimestampValue structure

The timestamp associated with the message.

ResetActionConfiguration

Description

Contains the configuration information of a reset action.

Members

note

Type: string

The note that you can leave when you reset the alarm.

ResetAlarmActionRequest

Description

Information needed to reset the alarm.

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

note

Type: string

The note that you can leave when you reset the alarm.

requestId

Required: Yes
Type: string

The request ID. Each ID must be unique within each batch.

ResourceNotFoundException

Description

The resource was not found.

Members

message

Type: string

The message for the exception.

RuleEvaluation

Description

Information needed to evaluate data.

Members

simpleRuleEvaluation

Type: SimpleRuleEvaluation structure

Information needed to compare two values with a comparison operator.

ServiceUnavailableException

Description

The service is currently unavailable.

Members

message

Type: string

The message for the exception.

SimpleRuleEvaluation

Description

Information needed to compare two values with a comparison operator.

Members

inputPropertyValue

Type: string

The value of the input property, on the left side of the comparison operator.

operator

Type: string

The comparison operator.

thresholdValue

Type: string

The threshold value, on the right side of the comparison operator.

SnoozeActionConfiguration

Description

Contains the configuration information of a snooze action.

Members

note

Type: string

The note that you can leave when you snooze the alarm.

snoozeDuration

Type: int

The snooze time in seconds. The alarm automatically changes to the NORMAL state after this duration.

SnoozeAlarmActionRequest

Description

Information needed to snooze the alarm.

Members

alarmModelName

Required: Yes
Type: string

The name of the alarm model.

keyValue

Type: string

The value of the key used as a filter to select only the alarms associated with the key.

note

Type: string

The note that you can leave when you snooze the alarm.

requestId

Required: Yes
Type: string

The request ID. Each ID must be unique within each batch.

snoozeDuration

Required: Yes
Type: int

The snooze time in seconds. The alarm automatically changes to the NORMAL state after this duration.

StateChangeConfiguration

Description

Contains the configuration information of alarm state changes.

Members

triggerType

Type: string

The trigger type. If the value is SNOOZE_TIMEOUT, the snooze duration ends and the alarm automatically changes to the NORMAL state.

SystemEvent

Description

Contains information about alarm state changes.

Members

eventType

Type: string

The event type. If the value is STATE_CHANGE, the event contains information about alarm state changes.

stateChangeConfiguration

Type: StateChangeConfiguration structure

Contains the configuration information of alarm state changes.

ThrottlingException

Description

The request could not be completed due to throttling.

Members

message

Type: string

The message for the exception.

Timer

Description

The current state of a timer.

Members

name

Required: Yes
Type: string

The name of the timer.

timestamp

Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The expiration time for the timer.

TimerDefinition

Description

The new setting of a timer.

Members

name

Required: Yes
Type: string

The name of the timer.

seconds

Required: Yes
Type: int

The new setting of the timer (the number of seconds before the timer elapses).

TimestampValue

Description

Contains information about a timestamp.

Members

timeInMillis

Type: long (int|float)

The value of the timestamp, in the Unix epoch format.

UpdateDetectorRequest

Description

Information used to update the detector (instance).

Members

detectorModelName

Required: Yes
Type: string

The name of the detector model that created the detectors (instances).

keyValue

Type: string

The value of the input key attribute (identifying the device or system) that caused the creation of this detector (instance).

messageId

Required: Yes
Type: string

The ID to assign to the detector update "message". Each "messageId" must be unique within each batch sent.

state

Required: Yes
Type: DetectorStateDefinition structure

The new state, variable values, and timer settings of the detector (instance).

Variable

Description

The current state of the variable.

Members

name

Required: Yes
Type: string

The name of the variable.

value

Required: Yes
Type: string

The current value of the variable.

VariableDefinition

Description

The new value of the variable.

Members

name

Required: Yes
Type: string

The name of the variable.

value

Required: Yes
Type: string

The new value of the variable.

Namespaces

Classes

Interfaces

Traits

Exceptions

Functions

AWS IoT Events Data 2018-10-23

Operation Summary

Operations

BatchAcknowledgeAlarm

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchDeleteDetector

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchDisableAlarm

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchEnableAlarm

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchPutMessage

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchResetAlarm

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchSnoozeAlarm

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

BatchUpdateDetector

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members

Errors

DescribeAlarm

Parameter Syntax

Parameter Details

Members

Result Syntax

Result Details

Members