Skip to content
v2.275.0

BehaviorProperty Struct ​

A Device Defender security profile behavior.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iot as iot } from 'aws-cdk-lib';
const behaviorProperty: iot.CfnSecurityProfile.BehaviorProperty = {
  name: 'name',

  // the properties below are optional
  criteria: {
    comparisonOperator: 'comparisonOperator',
    consecutiveDatapointsToAlarm: 123,
    consecutiveDatapointsToClear: 123,
    durationSeconds: 123,
    mlDetectionConfig: {
      confidenceLevel: 'confidenceLevel',
    },
    statisticalThreshold: {
      statistic: 'statistic',
    },
    value: {
      cidrs: ['cidrs'],
      count: 'count',
      number: 123,
      numbers: [123],
      ports: [123],
      strings: ['strings'],
    },
  },
  exportMetric: false,
  metric: 'metric',
  metricDimension: {
    dimensionName: 'dimensionName',

    // the properties below are optional
    operator: 'operator',
  },
  suppressAlerts: false,
};

Properties ​

criteriaoptionalIResolvable | CfnSecurityProfile.BehaviorCriteriaPropertycriteriaoptionaltyping.Union[IResolvable, BehaviorCriteriaProperty]criteriaoptionalIResolvableCriteriaoptionalIResolvableCriteriaoptionalinterface{}#
The criteria that determine if a device is behaving normally in regard to the `metric` .

In the AWS IoT console, you can choose to be sent an alert through Amazon SNS when AWS IoT Device Defender detects that a device is behaving anomalously.

exportMetricoptionalboolean | IResolvableexport_metricoptionaltyping.Union[bool, IResolvable]exportMetricoptionalBooleanExportMetricoptionalboolExportMetricoptionalinterface{}#
Value indicates exporting metrics related to the behavior when it is true.
metricoptionalstringmetricoptionalstrmetricoptionalStringMetricoptionalstringMetricoptional*string#
What is measured by the behavior.
metricDimensionoptionalIResolvable | CfnSecurityProfile.MetricDimensionPropertymetric_dimensionoptionaltyping.Union[IResolvable, MetricDimensionProperty]metricDimensionoptionalIResolvableMetricDimensionoptionalIResolvableMetricDimensionoptionalinterface{}#
The dimension of the metric.
namestringnamestrnameStringNamestringName*stringrequired#
The name you've given to the behavior.
suppressAlertsoptionalboolean | IResolvablesuppress_alertsoptionaltyping.Union[bool, IResolvable]suppressAlertsoptionalBooleanSuppressAlertsoptionalboolSuppressAlertsoptionalinterface{}#
The alert status.

If you set the value to true , alerts will be suppressed.