SageMaker / Client / list_monitoring_executions

list_monitoring_executions

SageMaker.Client.list_monitoring_executions(**kwargs)

Returns list of all monitoring job executions.

See also: AWS API Documentation

Request Syntax

response = client.list_monitoring_executions(
    MonitoringScheduleName='string',
    EndpointName='string',
    SortBy='CreationTime'|'ScheduledTime'|'Status',
    SortOrder='Ascending'|'Descending',
    NextToken='string',
    MaxResults=123,
    ScheduledTimeBefore=datetime(2015, 1, 1),
    ScheduledTimeAfter=datetime(2015, 1, 1),
    CreationTimeBefore=datetime(2015, 1, 1),
    CreationTimeAfter=datetime(2015, 1, 1),
    LastModifiedTimeBefore=datetime(2015, 1, 1),
    LastModifiedTimeAfter=datetime(2015, 1, 1),
    StatusEquals='Pending'|'Completed'|'CompletedWithViolations'|'InProgress'|'Failed'|'Stopping'|'Stopped',
    MonitoringJobDefinitionName='string',
    MonitoringTypeEquals='DataQuality'|'ModelQuality'|'ModelBias'|'ModelExplainability'
)

Parameters:

• MonitoringScheduleName (string) – Name of a specific schedule to fetch jobs for.

• EndpointName (string) – Name of a specific endpoint to fetch jobs for.

• SortBy (string) – Whether to sort the results by the Status, CreationTime, or ScheduledTime field. The default is CreationTime.

• SortOrder (string) – Whether to sort the results in Ascending or Descending order. The default is Descending.

• NextToken (string) – The token returned if the response is truncated. To retrieve the next set of job executions, use it in the next request.

• MaxResults (integer) – The maximum number of jobs to return in the response. The default value is 10.

• ScheduledTimeBefore (datetime) – Filter for jobs scheduled before a specified time.

• ScheduledTimeAfter (datetime) – Filter for jobs scheduled after a specified time.

• CreationTimeBefore (datetime) – A filter that returns only jobs created before a specified time.

• CreationTimeAfter (datetime) – A filter that returns only jobs created after a specified time.

• LastModifiedTimeBefore (datetime) – A filter that returns only jobs modified after a specified time.

• LastModifiedTimeAfter (datetime) – A filter that returns only jobs modified before a specified time.

• StatusEquals (string) – A filter that retrieves only jobs with a specific status.

• MonitoringJobDefinitionName (string) – Gets a list of the monitoring job runs of the specified monitoring job definitions.

• MonitoringTypeEquals (string) – A filter that returns only the monitoring job runs of the specified monitoring type.

Return type:

dict

Returns:

Response Syntax

{
    'MonitoringExecutionSummaries': [
        {
            'MonitoringScheduleName': 'string',
            'ScheduledTime': datetime(2015, 1, 1),
            'CreationTime': datetime(2015, 1, 1),
            'LastModifiedTime': datetime(2015, 1, 1),
            'MonitoringExecutionStatus': 'Pending'|'Completed'|'CompletedWithViolations'|'InProgress'|'Failed'|'Stopping'|'Stopped',
            'ProcessingJobArn': 'string',
            'EndpointName': 'string',
            'FailureReason': 'string',
            'MonitoringJobDefinitionName': 'string',
            'MonitoringType': 'DataQuality'|'ModelQuality'|'ModelBias'|'ModelExplainability'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • MonitoringExecutionSummaries (list) –

    A JSON array in which each element is a summary for a monitoring execution.

    • (dict) –

      Summary of information about the last monitoring job to run.

      • MonitoringScheduleName (string) –

        The name of the monitoring schedule.

      • ScheduledTime (datetime) –

        The time the monitoring job was scheduled.

      • CreationTime (datetime) –

        The time at which the monitoring job was created.

      • LastModifiedTime (datetime) –

        A timestamp that indicates the last time the monitoring job was modified.

      • MonitoringExecutionStatus (string) –

        The status of the monitoring job.

      • ProcessingJobArn (string) –

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

      • EndpointName (string) –

        The name of the endpoint used to run the monitoring job.

      • FailureReason (string) –

        Contains the reason a monitoring job failed, if it failed.

      • MonitoringJobDefinitionName (string) –

        The name of the monitoring job.

      • MonitoringType (string) –

        The type of the monitoring job.

  • NextToken (string) –

    The token returned if the response is truncated. To retrieve the next set of job executions, use it in the next request.