DescribeMonitoringSchedule - Amazon SageMaker
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

DescribeMonitoringSchedule

Describes the schedule for a monitoring job.

Request Syntax

{ "MonitoringScheduleName": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

MonitoringScheduleName

Name of a previously created monitoring schedule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,62}$

Required: Yes

Response Syntax

{ "CreationTime": number, "EndpointName": "string", "FailureReason": "string", "LastModifiedTime": number, "LastMonitoringExecutionSummary": { "CreationTime": number, "EndpointName": "string", "FailureReason": "string", "LastModifiedTime": number, "MonitoringExecutionStatus": "string", "MonitoringJobDefinitionName": "string", "MonitoringScheduleName": "string", "MonitoringType": "string", "ProcessingJobArn": "string", "ScheduledTime": number }, "MonitoringScheduleArn": "string", "MonitoringScheduleConfig": { "MonitoringJobDefinition": { "BaselineConfig": { "BaseliningJobName": "string", "ConstraintsResource": { "S3Uri": "string" }, "StatisticsResource": { "S3Uri": "string" } }, "Environment": { "string" : "string" }, "MonitoringAppSpecification": { "ContainerArguments": [ "string" ], "ContainerEntrypoint": [ "string" ], "ImageUri": "string", "PostAnalyticsProcessorSourceUri": "string", "RecordPreprocessorSourceUri": "string" }, "MonitoringInputs": [ { "BatchTransformInput": { "DataCapturedDestinationS3Uri": "string", "DatasetFormat": { "Csv": { "Header": boolean }, "Json": { "Line": boolean }, "Parquet": { } }, "EndTimeOffset": "string", "ExcludeFeaturesAttribute": "string", "FeaturesAttribute": "string", "InferenceAttribute": "string", "LocalPath": "string", "ProbabilityAttribute": "string", "ProbabilityThresholdAttribute": number, "S3DataDistributionType": "string", "S3InputMode": "string", "StartTimeOffset": "string" }, "EndpointInput": { "EndpointName": "string", "EndTimeOffset": "string", "ExcludeFeaturesAttribute": "string", "FeaturesAttribute": "string", "InferenceAttribute": "string", "LocalPath": "string", "ProbabilityAttribute": "string", "ProbabilityThresholdAttribute": number, "S3DataDistributionType": "string", "S3InputMode": "string", "StartTimeOffset": "string" } } ], "MonitoringOutputConfig": { "KmsKeyId": "string", "MonitoringOutputs": [ { "S3Output": { "LocalPath": "string", "S3UploadMode": "string", "S3Uri": "string" } } ] }, "MonitoringResources": { "ClusterConfig": { "InstanceCount": number, "InstanceType": "string", "VolumeKmsKeyId": "string", "VolumeSizeInGB": number } }, "NetworkConfig": { "EnableInterContainerTrafficEncryption": boolean, "EnableNetworkIsolation": boolean, "VpcConfig": { "SecurityGroupIds": [ "string" ], "Subnets": [ "string" ] } }, "RoleArn": "string", "StoppingCondition": { "MaxRuntimeInSeconds": number } }, "MonitoringJobDefinitionName": "string", "MonitoringType": "string", "ScheduleConfig": { "DataAnalysisEndTime": "string", "DataAnalysisStartTime": "string", "ScheduleExpression": "string" } }, "MonitoringScheduleName": "string", "MonitoringScheduleStatus": "string", "MonitoringType": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

CreationTime

The time at which the monitoring job was created.

Type: Timestamp

EndpointName

The name of the endpoint for the monitoring job.

Type: String

Length Constraints: Maximum length of 63.

Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,62}

FailureReason

A string, up to one KB in size, that contains the reason a monitoring job failed, if it failed.

Type: String

Length Constraints: Maximum length of 1024.

LastModifiedTime

The time at which the monitoring job was last modified.

Type: Timestamp

LastMonitoringExecutionSummary

Describes metadata on the last execution to run, if there was one.

Type: MonitoringExecutionSummary object

MonitoringScheduleArn

The Amazon Resource Name (ARN) of the monitoring schedule.

Type: String

Length Constraints: Maximum length of 256.

Pattern: .*

MonitoringScheduleConfig

The configuration object that specifies the monitoring schedule and defines the monitoring job.

Type: MonitoringScheduleConfig object

MonitoringScheduleName

Name of the monitoring schedule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,62}$

MonitoringScheduleStatus

The status of an monitoring job.

Type: String

Valid Values: Pending | Failed | Scheduled | Stopped

MonitoringType

The type of the monitoring job that this schedule runs. This is one of the following values.

  • DATA_QUALITY - The schedule is for a data quality monitoring job.

  • MODEL_QUALITY - The schedule is for a model quality monitoring job.

  • MODEL_BIAS - The schedule is for a bias monitoring job.

  • MODEL_EXPLAINABILITY - The schedule is for an explainability monitoring job.

Type: String

Valid Values: DataQuality | ModelQuality | ModelBias | ModelExplainability

Errors

For information about the errors that are common to all actions, see Common Errors.

ResourceNotFound

Resource being access is not found.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: