AWS IoT Service Tables

The AWS IoT Service integration uses the following tables

Tables

AWSIoTAlertTargets

NameTypeDescription
ARNstringThe Amazon Resource Name (ARN) of the notification target to which alerts are sent.
BatchDatedatetimeThe date when the data was collected or processed.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
RoleARNstringThe ARN of the role that grants permission to send alerts to the notification target.

AWSIoTAuditChecks

NameTypeDescription
CompliantbitIndicates whether the audit check is compliant (true) or non-compliant (false).
RunStatusstringThe status of the audit check execution. Possible values include IN_PROGRESS, WAITING_FOR_DATA_COLLECTION, CANCELED, COMPLETED_COMPLIANT, COMPLETED_NON_COMPLIANT, FAILED, and STOPPED.
ErrorCodestringThe error code returned if the audit check execution fails.
MessagestringA message providing additional information about the audit check execution or failure.
AuditNamestringThe name assigned to the specific audit.
NonCompliantResourcesCountbigintThe number of resources that were found non-compliant during the audit check.
SuppressedNonCompliantResourcesCountbigintThe number of non-compliant resources for which findings have been suppressed.
TotalResourcesCountbigintThe total number of resources that were evaluated during the audit check.
BatchDatedatetimeThe date when the data was collected or processed.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
IDintegerA unique identifier for the audit check instance.

AWSIoTAuditFindings

NameTypeDescription
AWSIoTAuditCheckConfigIDintegerAn identifier linking the audit finding to a specific AWS IoT audit check configuration.
AWSIoTNonCompliantResourceConfigIDintegerAn identifier linking the audit finding to a specific non-compliant resource configuration in AWS IoT.
TimedatetimeThe time the result (finding) was discovered.
IsSuppressedbitIndicates whether the audit finding was suppressed during reporting.
ReasonForNonCompliancestringThe reason the resource was noncompliant.
ReasonForNonComplianceCodestringA code that indicates the reason that the resource was noncompliant.
SeveritystringThe severity of the result (finding). Valid values are CRITICAL, HIGH, MEDIUM, and LOW.
AuditStartTimedatetimeThe time the audit started.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
BatchDatedatetimeThe date when the data was collected or processed.
AuditIDstringThe ID of the audit that generated this result (finding).
AWSIoTAuditCheckIDintegerA unique identifier for the specific AWS IoT audit check.
AWSIoTNonCompliantResourceIDintegerA unique identifier for the non-compliant resource associated with the audit finding.
IDstringA unique identifier for the audit finding instance.

AWSIoTBehaviors

NameTypeDescription
AWSIoTMetricConfigIDintegerAn identifier linking the behavior to a specific AWS IoT metric configuration.
AWSIoTSecurityProfileConfigIDintegerAn identifier linking the behavior to a specific AWS IoT Security Profile configuration.
AWSIoTSecurityProfileARNstringThe Amazon Resource Name (ARN) of the AWS IoT Security Profile associated with the behavior.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
NamestringThe name of the behavior.
CriteriaMetricValueNumbersJsonstringJSON representation of the numeric metric values used in the behavior's criteria.
CriteriaMetricValuePortsJsonstringJSON representation of the port metric values used in the behavior's criteria.
CriteriaMetricValueStringsJsonstringJSON representation of the string metric values used in the behavior's criteria.
CriteriaMetricValueCountbigintThe count of metric values used in the behavior's criteria.
CriteriaMetricValueNumberfloatA specific numeric metric value used in the behavior's criteria.
SuppressAlertsbitIndicates whether alerts for this behavior are suppressed.
ExportbitIndicates whether the behavior's metrics are exported.
CriteriaComparisonOperatorstringThe operator used to compare the metric value to the threshold. Possible values include less-than, less-than-equals, greater-than, and greater-than-equals.
CriteriaDatapointsToAlarmintegerThe number of consecutive datapoints that must be outside the threshold for the alarm to be triggered.
CriteriaDatapointsToClearintegerThe number of consecutive datapoints that must be within the threshold for the alarm to be cleared.
CriteriaDurationSecondsintegerThe duration (in seconds) over which the behavior is evaluated.
CriteriaStatisticalThresholdStatisticstringThe percentile that resolves to a threshold value by which compliance with a behavior is determined. Possible values include p50, p90, p99
BatchDatedatetimeThe date when the data was collected or processed.
CriteriaMachineLearningDetectionConfigConfidenceLevelstringThe confidence level of the machine learning model used to detect anomalies. Possible values include high, medium, and low.
AWSIoTMetricIDintegerA unique identifier for the AWS IoT metric associated with the behavior.
CriteriaMetricValueCidrsJsonstringJSON representation of the CIDR metric values used in the behavior's criteria.
IDintegerA unique identifier for the behavior instance.

AWSIoTMetrics

NameTypeDescription
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
MetricstringThe name of the metric. For example, in the context of AWS IoT Device Defender, this could refer to predefined metrics like MessagesSent or custom metrics defined for monitoring specific behaviors.
ExportbitIndicates whether the metric is configured to be exported.
DimensionNamestringThe name of the dimension associated with the metric. Dimensions are attributes that can be used to filter metrics. For example, a dimension could be ThingType to filter metrics by the type of device.
OperatorstringDefines how the dimensionValues of a dimension are interpreted. Valid values are IN and NOT_IN. For example, with the IN operator, a metric is included only if it matches one of the specified dimension values.
BatchDatedatetimeThe date when the data was collected or processed.
IDintegerA unique identifier for the metric instance.

AWSIoTResources

NameTypeDescription
AWSIoTAuditFindingConfigIDintegerAn identifier linking the resource to a specific AWS IoT audit finding configuration.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
AccountstringThe account with which the resource is associated.
TypestringThe type or category of the resource.
IssuerCertificateSerialNumberstringThe serial number of the issuer certificate.
IssuerCertificateSubjectstringThe subject of the issuer certificate.
PolicyVersionNamestringThe name of the policy associated with the resource.
BatchDatedatetimeThe date when the data was collected or processed.
DeviceCertificateARNstringThe ARN of the identified device certificate.
IAMRoleARNstringThe ARN of the IAM role that has overly permissive actions.
AWSIoTAuditFindingIDstringA unique identifier for the AWS IoT audit finding associated with the resource.
CACertificateIDstringThe ID of the CA certificate used to authorize the certificate.
ClientIDstringThe client ID.
CognitoIdentityPoolIDstringThe ID of the Amazon Cognito identity pool.
DeviceCertificateIDstringThe ID of the certificate attached to the resource.
IDintegerA unique identifier for the resource instance.
IssuerCertificateIssuerIDstringThe issuer ID of the issuer certificate.
PolicyVersionIDstringThe ID of the version of the policy associated with the resource.
RoleAliasARNstringThe ARN of the role alias that has overly permissive actions.

AWSIoTSecurityProfiles

NameTypeDescription
ARNstringThe Amazon Resource Name (ARN) of the security profile.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
NamestringThe name you've given to the security profile.
CreationDatedatetimeThe date and time when the security profile was created.
LastModifiedDatedatetimeThe date and time when the security profile was last modified.
BatchDatedatetimeThe date when the data was collected or processed.

AWSIoTThingAttributes

NameTypeDescription
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
NamestringThe name of the attribute. In AWS IoT, attributes are key-value pairs associated with a thing. The attribute name can be up to 128 characters long and can include letters, numbers, and the following special characters:_ . , @ / : # -.
ValuestringThe value of the attribute. The attribute value can be up to 800 characters long and can include letters, numbers, and the following special characters: _ . , @ / : # = [ ] -.
BatchDatedatetimeThe date when the data was collected or processed.

AWSIoTThings

NameTypeDescription
ARNstringThe Amazon Resource Name (ARN) of the thing.
AWSIoTThingTypeConfigIDintegerAn identifier linking the thing to a specific AWS IoT Thing Type configuration.
AWSIoTThingTypeARNstringThe ARN of the thing type associated with the thing.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
NamestringThe name of the thing.
VersionbigintThe version of the thing record in the registry.
BatchDatedatetimeThe date when the data was collected or processed.

AWSIoTThingTypes

NameTypeDescription
ARNstringThe Amazon Resource Name (ARN) of the thing type.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
NamestringThe name of the thing type.
DescriptionstringThe description of the thing type.
CreationDatedatetimeThe date and time when the thing type was created.
DeprecationDatedatetimeThe date and time when the thing type was deprecated.
DeprecatedbitIndicates whether the thing type is deprecated.
BatchDatedatetimeThe date when the data was collected or processed.

AWSIoTViolationEvents

NameTypeDescription
AWSIoTBehaviorConfigIDintegerAn identifier linking the violation event to a specific AWS IoT behavior configuration.
AWSIoTSecurityProfileConfigIDintegerAn identifier linking the violation event to a specific AWS IoT security profile configuration.
AWSIoTThingConfigIDintegerAn identifier linking the violation event to a specific AWS IoT thing configuration.
AWSIoTSecurityProfileARNstringThe Amazon Resource Name (ARN) of the security profile.
AWSIoTThingARNstringThe ARN of the thing resource.
ConfigIDintegerAn identifier for the specific configuration or data snapshot.
MetricValueNumbersJsonstringJSON representation of metric values that are numbers.
MetricValuePortsJsonstringJSON representation of metric values that are port numbers.
MetricValueStringsJsonstringJSON representation of metric values that are strings.
MetricValueCountbigintCount of metric values.
MetricValueNumberfloatA single numeric metric value.
VerificationStatestringThe verification state of the violation (detect alarm). Valid values are FALSE_POSITIVE, BENIGN_POSITIVE, TRUE_POSITIVE, and UNKNOWN.
VerificationStateDescriptionstringThe description of the verification state of the violation.
ViolationEventTimedatetimeThe time the violation event occurred.
ViolationEventTypestringThe type of violation event. Valid values are in-alarm, alarm-cleared, and alarm-invalidated.
BatchDatedatetimeThe date when the data was collected or processed.
AWSIoTBehaviorIDintegerAn identifier linking the violation event to a specific AWS IoT behavior.
ConfidenceLevelstringThe confidence level of the violation detection.
IDstringA unique identifier for the violation event instance.
MetricValueCidrsJsonstringJSON representation of metric values that are CIDR blocks.

Bridge Tables

AWSIoTAlertTargets_AWSIoTSecurityProfiles

NameTypeDescription
AWSIoTAlertTargetConfigIDintegerAn identifier for the specific configuration or data snapshot for the alert target.
AWSIoTSecurityProfileConfigIDintegerAn identifier for the specific configuration or data snapshot for the security profile.
AWSIoTAlertTargetARNstringThe Amazon Resource Name (ARN) of the notification target to which alerts are sent.
AWSIoTSecurityProfileARNstringThe Amazon Resource Name (ARN) of the security profile.

AWSIoTAuditFindings_AWSIoTRelatedResources

NameTypeDescription
AWSIoTAuditFindingConfigIDintegerAn identifier for the specific configuration or data snapshot.
AWSIoTRelatedResourceConfigIDintegerAn identifier for the specific configuration or data snapshot.
AWSIoTAuditFindingIDstringA unique identifier for the audit finding instance.
AWSIoTRelatedResourceIDintegerA unique identifier for the resource instance.

AWSIoTMetrics_AWSIoTSecurityProfiles

NameTypeDescription
AWSIoTMetricConfigIDintegerAn identifier for the specific configuration or data snapshot.
AWSIoTSecurityProfileConfigIDintegerAn identifier for the specific configuration or data snapshot for the security profile.
AWSIoTSecurityProfileARNstringThe Amazon Resource Name (ARN) of the security profile.
AWSIoTMetricIDintegerA unique identifier for the metric instance.

AWSIoTThings_AWSIoTThingAttributes

NameTypeDescription
AWSIoTThingAttributeConfigIDintegerAn identifier for the specific configuration or data snapshot.
AWSIoTThingConfigIDintegerAn identifier for the specific configuration or data snapshot.
AWSIoTThingARNstringThe Amazon Resource Name (ARN) of the thing.
AWSIoTThingAttributeNamestringThe name of the attribute. In AWS IoT, attributes are key-value pairs associated with a thing. The attribute name can be up to 128 characters long and can include letters, numbers, and the following special characters: _ . , @ / : # -.
AWSIoTThingAttributeValuestringThe value of the attribute. The attribute value can be up to 800 characters long and can include letters, numbers, and the following special characters: _ . , @ / : # = [ ] -.

Did this page help you?