--- # generated by https://github.com/hashicorp/terraform-plugin-docs page_title: "awscc_sagemaker_model_quality_job_definition Resource - terraform-provider-awscc" subcategory: "" description: |- Resource Type definition for AWS::SageMaker::ModelQualityJobDefinition --- # awscc_sagemaker_model_quality_job_definition (Resource) Resource Type definition for AWS::SageMaker::ModelQualityJobDefinition ## Schema ### Required - `job_resources` (Attributes) Identifies the resources to deploy for a monitoring job. (see [below for nested schema](#nestedatt--job_resources)) - `model_quality_app_specification` (Attributes) Container image configuration object for the monitoring job. (see [below for nested schema](#nestedatt--model_quality_app_specification)) - `model_quality_job_input` (Attributes) The inputs for a monitoring job. (see [below for nested schema](#nestedatt--model_quality_job_input)) - `model_quality_job_output_config` (Attributes) The output configuration for monitoring jobs. (see [below for nested schema](#nestedatt--model_quality_job_output_config)) - `role_arn` (String) The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf. ### Optional - `job_definition_name` (String) The name of the job definition. - `model_quality_baseline_config` (Attributes) Baseline configuration used to validate that the data conforms to the specified constraints and statistics. (see [below for nested schema](#nestedatt--model_quality_baseline_config)) - `network_config` (Attributes) Networking options for a job, such as network traffic encryption between containers, whether to allow inbound and outbound network calls to and from containers, and the VPC subnets and security groups to use for VPC-enabled jobs. (see [below for nested schema](#nestedatt--network_config)) - `stopping_condition` (Attributes) Specifies a time limit for how long the monitoring job is allowed to run. (see [below for nested schema](#nestedatt--stopping_condition)) - `tags` (Attributes List) An array of key-value pairs to apply to this resource. (see [below for nested schema](#nestedatt--tags)) ### Read-Only - `creation_time` (String) The time at which the job definition was created. - `id` (String) Uniquely identifies the resource. - `job_definition_arn` (String) The Amazon Resource Name (ARN) of job definition. ### Nested Schema for `job_resources` Required: - `cluster_config` (Attributes) Configuration for the cluster used to run model monitoring jobs. (see [below for nested schema](#nestedatt--job_resources--cluster_config)) ### Nested Schema for `job_resources.cluster_config` Required: - `instance_count` (Number) The number of ML compute instances to use in the model monitoring job. For distributed processing jobs, specify a value greater than 1. The default value is 1. - `instance_type` (String) The ML compute instance type for the processing job. - `volume_kms_key_id` (String) The AWS Key Management Service (AWS KMS) key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance(s) that run the model monitoring job. - `volume_size_in_gb` (Number) The size of the ML storage volume, in gigabytes, that you want to provision. You must specify sufficient ML storage for your scenario. ### Nested Schema for `model_quality_app_specification` Required: - `container_arguments` (List of String) An array of arguments for the container used to run the monitoring job. - `container_entrypoint` (List of String) Specifies the entrypoint for a container used to run the monitoring job. - `environment` (Map of String) Sets the environment variables in the Docker container - `image_uri` (String) The container image to be run by the monitoring job. - `post_analytics_processor_source_uri` (String) An Amazon S3 URI to a script that is called after analysis has been performed. Applicable only for the built-in (first party) containers. - `problem_type` (String) The status of the monitoring job. - `record_preprocessor_source_uri` (String) An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers ### Nested Schema for `model_quality_job_input` Required: - `endpoint_input` (Attributes) The endpoint for a monitoring job. (see [below for nested schema](#nestedatt--model_quality_job_input--endpoint_input)) - `ground_truth_s3_input` (Attributes) Ground truth input provided in S3 (see [below for nested schema](#nestedatt--model_quality_job_input--ground_truth_s3_input)) ### Nested Schema for `model_quality_job_input.endpoint_input` Required: - `end_time_offset` (String) Monitoring end time offset, e.g. PT0H - `endpoint_name` (String) The name of the endpoint used to run the monitoring job. - `inference_attribute` (String) Index or JSONpath to locate predicted label(s) - `local_path` (String) Path to the filesystem where the endpoint data is available to the container. - `probability_attribute` (String) Index or JSONpath to locate probabilities - `probability_threshold_attribute` (Number) - `s3_data_distribution_type` (String) Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key. Defauts to FullyReplicated - `s3_input_mode` (String) Whether the Pipe or File is used as the input mode for transfering data for the monitoring job. Pipe mode is recommended for large datasets. File mode is useful for small files that fit in memory. Defaults to File. - `start_time_offset` (String) Monitoring start time offset, e.g. -PT1H ### Nested Schema for `model_quality_job_input.ground_truth_s3_input` Required: - `s3_uri` (String) A URI that identifies the Amazon S3 storage location where Amazon SageMaker saves the results of a monitoring job. ### Nested Schema for `model_quality_job_output_config` Required: - `kms_key_id` (String) The AWS Key Management Service (AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption. - `monitoring_outputs` (Attributes List) Monitoring outputs for monitoring jobs. This is where the output of the periodic monitoring jobs is uploaded. (see [below for nested schema](#nestedatt--model_quality_job_output_config--monitoring_outputs)) ### Nested Schema for `model_quality_job_output_config.monitoring_outputs` Required: - `s3_output` (Attributes) Information about where and how to store the results of a monitoring job. (see [below for nested schema](#nestedatt--model_quality_job_output_config--monitoring_outputs--s3_output)) ### Nested Schema for `model_quality_job_output_config.monitoring_outputs.s3_output` Required: - `local_path` (String) The local path to the Amazon S3 storage location where Amazon SageMaker saves the results of a monitoring job. LocalPath is an absolute path for the output data. - `s3_upload_mode` (String) Whether to upload the results of the monitoring job continuously or after the job completes. - `s3_uri` (String) A URI that identifies the Amazon S3 storage location where Amazon SageMaker saves the results of a monitoring job. ### Nested Schema for `model_quality_baseline_config` Optional: - `baselining_job_name` (String) The name of a processing job - `constraints_resource` (Attributes) The baseline constraints resource for a monitoring job. (see [below for nested schema](#nestedatt--model_quality_baseline_config--constraints_resource)) ### Nested Schema for `model_quality_baseline_config.constraints_resource` Optional: - `s3_uri` (String) The Amazon S3 URI for baseline constraint file in Amazon S3 that the current monitoring job should validated against. ### Nested Schema for `network_config` Optional: - `enable_inter_container_traffic_encryption` (Boolean) Whether to encrypt all communications between distributed processing jobs. Choose True to encrypt communications. Encryption provides greater security for distributed processing jobs, but the processing might take longer. - `enable_network_isolation` (Boolean) Whether to allow inbound and outbound network calls to and from the containers used for the processing job. - `vpc_config` (Attributes) Specifies a VPC that your training jobs and hosted models have access to. Control access to and from your training and model containers by configuring the VPC. (see [below for nested schema](#nestedatt--network_config--vpc_config)) ### Nested Schema for `network_config.vpc_config` Optional: - `security_group_ids` (List of String) The VPC security group IDs, in the form sg-xxxxxxxx. Specify the security groups for the VPC that is specified in the Subnets field. - `subnets` (List of String) The ID of the subnets in the VPC to which you want to connect to your monitoring jobs. ### Nested Schema for `stopping_condition` Optional: - `max_runtime_in_seconds` (Number) The maximum runtime allowed in seconds. ### Nested Schema for `tags` Optional: - `key` (String) The key name of the tag. You can specify a value that is 1 to 127 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -. - `value` (String) The value for the tag. You can specify a value that is 1 to 255 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -. ## Import Import is supported using the following syntax: ```shell $ terraform import awscc_sagemaker_model_quality_job_definition.example ```