

# ViolationEvent
<a name="API_ViolationEvent"></a>

Information about a Device Defender security profile behavior violation.

## Contents
<a name="API_ViolationEvent_Contents"></a>

 ** behavior **   <a name="iot-Type-ViolationEvent-behavior"></a>
The behavior that was violated.  
Type: [Behavior](API_Behavior.md) object  
Required: No

 ** metricValue **   <a name="iot-Type-ViolationEvent-metricValue"></a>
The value of the metric (the measurement).  
Type: [MetricValue](API_MetricValue.md) object  
Required: No

 ** securityProfileName **   <a name="iot-Type-ViolationEvent-securityProfileName"></a>
The name of the security profile whose behavior was violated.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[a-zA-Z0-9:_-]+`   
Required: No

 ** thingName **   <a name="iot-Type-ViolationEvent-thingName"></a>
The name of the thing responsible for the violation event.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: No

 ** verificationState **   <a name="iot-Type-ViolationEvent-verificationState"></a>
The verification state of the violation (detect alarm).  
Type: String  
Valid Values: `FALSE_POSITIVE | BENIGN_POSITIVE | TRUE_POSITIVE | UNKNOWN`   
Required: No

 ** verificationStateDescription **   <a name="iot-Type-ViolationEvent-verificationStateDescription"></a>
The description of the verification state of the violation.  
Type: String  
Length Constraints: Maximum length of 1000.  
Pattern: `[^\p{Cntrl}]*`   
Required: No

 ** violationEventAdditionalInfo **   <a name="iot-Type-ViolationEvent-violationEventAdditionalInfo"></a>
 The details of a violation event.   
Type: [ViolationEventAdditionalInfo](API_ViolationEventAdditionalInfo.md) object  
Required: No

 ** violationEventTime **   <a name="iot-Type-ViolationEvent-violationEventTime"></a>
The time the violation event occurred.  
Type: Timestamp  
Required: No

 ** violationEventType **   <a name="iot-Type-ViolationEvent-violationEventType"></a>
The type of violation event.  
Type: String  
Valid Values: `in-alarm | alarm-cleared | alarm-invalidated`   
Required: No

 ** violationId **   <a name="iot-Type-ViolationEvent-violationId"></a>
The ID of the violation event.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[a-zA-Z0-9\-]+`   
Required: No

## See Also
<a name="API_ViolationEvent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/iot-2015-05-28/ViolationEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/iot-2015-05-28/ViolationEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/iot-2015-05-28/ViolationEvent) 