Package software.amazon.awscdk.services.sagemaker

Class CfnModelQualityJobDefinition

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.sagemaker.CfnModelQualityJobDefinition
All Implemented Interfaces:
IInspectable, ITaggable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.104.0 (build e79254c)", date="2024-11-22T02:24:09.230Z") @Stability(Stable) public class CfnModelQualityJobDefinition extends CfnResource implements IInspectable, ITaggable
Creates a definition for a job that monitors model quality and drift.

For information about model monitor, see Amazon SageMaker Model Monitor .

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.sagemaker.*;
 CfnModelQualityJobDefinition cfnModelQualityJobDefinition = CfnModelQualityJobDefinition.Builder.create(this, "MyCfnModelQualityJobDefinition")
         .jobResources(MonitoringResourcesProperty.builder()
                 .clusterConfig(ClusterConfigProperty.builder()
                         .instanceCount(123)
                         .instanceType("instanceType")
                         .volumeSizeInGb(123)
                         // the properties below are optional
                         .volumeKmsKeyId("volumeKmsKeyId")
                         .build())
                 .build())
         .modelQualityAppSpecification(ModelQualityAppSpecificationProperty.builder()
                 .imageUri("imageUri")
                 .problemType("problemType")
                 // the properties below are optional
                 .containerArguments(List.of("containerArguments"))
                 .containerEntrypoint(List.of("containerEntrypoint"))
                 .environment(Map.of(
                         "environmentKey", "environment"))
                 .postAnalyticsProcessorSourceUri("postAnalyticsProcessorSourceUri")
                 .recordPreprocessorSourceUri("recordPreprocessorSourceUri")
                 .build())
         .modelQualityJobInput(ModelQualityJobInputProperty.builder()
                 .groundTruthS3Input(MonitoringGroundTruthS3InputProperty.builder()
                         .s3Uri("s3Uri")
                         .build())
                 // the properties below are optional
                 .batchTransformInput(BatchTransformInputProperty.builder()
                         .dataCapturedDestinationS3Uri("dataCapturedDestinationS3Uri")
                         .datasetFormat(DatasetFormatProperty.builder()
                                 .csv(CsvProperty.builder()
                                         .header(false)
                                         .build())
                                 .json(JsonProperty.builder()
                                         .line(false)
                                         .build())
                                 .parquet(false)
                                 .build())
                         .localPath("localPath")
                         // the properties below are optional
                         .endTimeOffset("endTimeOffset")
                         .inferenceAttribute("inferenceAttribute")
                         .probabilityAttribute("probabilityAttribute")
                         .probabilityThresholdAttribute(123)
                         .s3DataDistributionType("s3DataDistributionType")
                         .s3InputMode("s3InputMode")
                         .startTimeOffset("startTimeOffset")
                         .build())
                 .endpointInput(EndpointInputProperty.builder()
                         .endpointName("endpointName")
                         .localPath("localPath")
                         // the properties below are optional
                         .endTimeOffset("endTimeOffset")
                         .inferenceAttribute("inferenceAttribute")
                         .probabilityAttribute("probabilityAttribute")
                         .probabilityThresholdAttribute(123)
                         .s3DataDistributionType("s3DataDistributionType")
                         .s3InputMode("s3InputMode")
                         .startTimeOffset("startTimeOffset")
                         .build())
                 .build())
         .modelQualityJobOutputConfig(MonitoringOutputConfigProperty.builder()
                 .monitoringOutputs(List.of(MonitoringOutputProperty.builder()
                         .s3Output(S3OutputProperty.builder()
                                 .localPath("localPath")
                                 .s3Uri("s3Uri")
                                 // the properties below are optional
                                 .s3UploadMode("s3UploadMode")
                                 .build())
                         .build()))
                 // the properties below are optional
                 .kmsKeyId("kmsKeyId")
                 .build())
         .roleArn("roleArn")
         // the properties below are optional
         .endpointName("endpointName")
         .jobDefinitionName("jobDefinitionName")
         .modelQualityBaselineConfig(ModelQualityBaselineConfigProperty.builder()
                 .baseliningJobName("baseliningJobName")
                 .constraintsResource(ConstraintsResourceProperty.builder()
                         .s3Uri("s3Uri")
                         .build())
                 .build())
         .networkConfig(NetworkConfigProperty.builder()
                 .enableInterContainerTrafficEncryption(false)
                 .enableNetworkIsolation(false)
                 .vpcConfig(VpcConfigProperty.builder()
                         .securityGroupIds(List.of("securityGroupIds"))
                         .subnets(List.of("subnets"))
                         .build())
                 .build())
         .stoppingCondition(StoppingConditionProperty.builder()
                 .maxRuntimeInSeconds(123)
                 .build())
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();

See Also:

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnModelQualityJobDefinition

      protected CfnModelQualityJobDefinition(software.amazon.jsii.JsiiObjectRef objRef)

    • CfnModelQualityJobDefinition

      protected CfnModelQualityJobDefinition(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • CfnModelQualityJobDefinition

      @Stability(Stable) public CfnModelQualityJobDefinition(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull CfnModelQualityJobDefinitionProps props)
      Parameters:
      scope - Scope in which this resource is defined. This parameter is required.
      id - Construct identifier for this resource (unique in its scope). This parameter is required.
      props - Resource properties. This parameter is required.

  • Method Details

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector - tree inspector to collect and process attributes. This parameter is required.

    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getAttrCreationTime

      @Stability(Stable) @NotNull public String getAttrCreationTime()
      The time when the job definition was created.

    • getAttrJobDefinitionArn

      @Stability(Stable) @NotNull public String getAttrJobDefinitionArn()
      The Amazon Resource Name (ARN) of the job definition.

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getTags

      @Stability(Stable) @NotNull public TagManager getTags()
      Tag Manager which manages the tags for this resource.
      Specified by:
      getTags in interface ITaggable

    • getJobResources

      @Stability(Stable) @NotNull public Object getJobResources()
      Identifies the resources to deploy for a monitoring job.

    • setJobResources

      @Stability(Stable) public void setJobResources(@NotNull IResolvable value)
      Identifies the resources to deploy for a monitoring job.

    • setJobResources

      @Stability(Stable) public void setJobResources(@NotNull CfnModelQualityJobDefinition.MonitoringResourcesProperty value)
      Identifies the resources to deploy for a monitoring job.

    • getModelQualityAppSpecification

      @Stability(Stable) @NotNull public Object getModelQualityAppSpecification()
      Container image configuration object for the monitoring job.

    • setModelQualityAppSpecification

      @Stability(Stable) public void setModelQualityAppSpecification(@NotNull IResolvable value)
      Container image configuration object for the monitoring job.

    • setModelQualityAppSpecification

      @Stability(Stable) public void setModelQualityAppSpecification(@NotNull CfnModelQualityJobDefinition.ModelQualityAppSpecificationProperty value)
      Container image configuration object for the monitoring job.

    • getModelQualityJobInput

      @Stability(Stable) @NotNull public Object getModelQualityJobInput()
      A list of the inputs that are monitored.

    • setModelQualityJobInput

      @Stability(Stable) public void setModelQualityJobInput(@NotNull IResolvable value)
      A list of the inputs that are monitored.

    • setModelQualityJobInput

      @Stability(Stable) public void setModelQualityJobInput(@NotNull CfnModelQualityJobDefinition.ModelQualityJobInputProperty value)
      A list of the inputs that are monitored.

    • getModelQualityJobOutputConfig

      @Stability(Stable) @NotNull public Object getModelQualityJobOutputConfig()
      The output configuration for monitoring jobs.

    • setModelQualityJobOutputConfig

      @Stability(Stable) public void setModelQualityJobOutputConfig(@NotNull IResolvable value)
      The output configuration for monitoring jobs.

    • setModelQualityJobOutputConfig

      @Stability(Stable) public void setModelQualityJobOutputConfig(@NotNull CfnModelQualityJobDefinition.MonitoringOutputConfigProperty value)
      The output configuration for monitoring jobs.

    • getRoleArn

      @Stability(Stable) @NotNull public String getRoleArn()
      The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf.

    • setRoleArn

      @Stability(Stable) public void setRoleArn(@NotNull String value)
      The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf.

    • getEndpointName

      @Stability(Stable) @Nullable public String getEndpointName()
      The name of the endpoint used to run the monitoring job.

    • setEndpointName

      @Stability(Stable) public void setEndpointName(@Nullable String value)
      The name of the endpoint used to run the monitoring job.

    • getJobDefinitionName

      @Stability(Stable) @Nullable public String getJobDefinitionName()
      The name of the monitoring job definition.

    • setJobDefinitionName

      @Stability(Stable) public void setJobDefinitionName(@Nullable String value)
      The name of the monitoring job definition.

    • getModelQualityBaselineConfig

      @Stability(Stable) @Nullable public Object getModelQualityBaselineConfig()
      Specifies the constraints and baselines for the monitoring job.

    • setModelQualityBaselineConfig

      @Stability(Stable) public void setModelQualityBaselineConfig(@Nullable IResolvable value)
      Specifies the constraints and baselines for the monitoring job.

    • setModelQualityBaselineConfig

      @Stability(Stable) public void setModelQualityBaselineConfig(@Nullable CfnModelQualityJobDefinition.ModelQualityBaselineConfigProperty value)
      Specifies the constraints and baselines for the monitoring job.

    • getNetworkConfig

      @Stability(Stable) @Nullable public Object getNetworkConfig()
      Specifies the network configuration for the monitoring job.

    • setNetworkConfig

      @Stability(Stable) public void setNetworkConfig(@Nullable IResolvable value)
      Specifies the network configuration for the monitoring job.

    • setNetworkConfig

      @Stability(Stable) public void setNetworkConfig(@Nullable CfnModelQualityJobDefinition.NetworkConfigProperty value)
      Specifies the network configuration for the monitoring job.

    • getStoppingCondition

      @Stability(Stable) @Nullable public Object getStoppingCondition()
      A time limit for how long the monitoring job is allowed to run before stopping.

    • setStoppingCondition

      @Stability(Stable) public void setStoppingCondition(@Nullable IResolvable value)
      A time limit for how long the monitoring job is allowed to run before stopping.

    • setStoppingCondition

      @Stability(Stable) public void setStoppingCondition(@Nullable CfnModelQualityJobDefinition.StoppingConditionProperty value)
      A time limit for how long the monitoring job is allowed to run before stopping.

    • getTagsRaw

      @Stability(Stable) @Nullable public List<CfnTag> getTagsRaw()
      An array of key-value pairs to apply to this resource.

    • setTagsRaw

      @Stability(Stable) public void setTagsRaw(@Nullable List<CfnTag> value)
      An array of key-value pairs to apply to this resource.