Skip to main content

behavior_model_training_summaries

Creates, updates, deletes, gets or lists a behavior_model_training_summaries resource.

Overview​

Namebehavior_model_training_summaries
TypeResource
Idaws.iot.behavior_model_training_summaries

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
behavior_namestringThe name of the behavior. (pattern: <code>[a-zA-Z0-9:_-]+</code>)
datapoints_collection_percentagenumber (double)The percentage of datapoints collected.
last_model_refresh_datestring (date-time)The date the model was last refreshed.
model_statusstringThe status of the behavior model. (PENDING_BUILD, ACTIVE, EXPIRED)
security_profile_namestringThe name of the security profile. (pattern: <code>[a-zA-Z0-9:_-]+</code>)
training_data_collection_start_datestring (date-time)The date a training model started collecting data.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_behavior_model_training_summariesselectregionsecurityProfileName, maxResults, nextTokenReturns a Device Defender's ML Detect Security Profile training model's status. Requires permission to access the GetBehaviorModelTrainingSummaries action.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of results to return at one time. The default is 10.
nextTokenstringThe token for the next set of results.
securityProfileNamestringThe name of the security profile.

SELECT examples​

Returns a Device Defender's ML Detect Security Profile training model's status. Requires permission to access the GetBehaviorModelTrainingSummaries action.

SELECT
behavior_name,
datapoints_collection_percentage,
last_model_refresh_date,
model_status,
security_profile_name,
training_data_collection_start_date
FROM aws.iot.behavior_model_training_summaries
WHERE region = '{{ region }}' -- required
AND securityProfileName = '{{ securityProfileName }}'
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;