SageMaker / Client / list_candidates_for_auto_ml_job

list_candidates_for_auto_ml_job#

SageMaker.Client.list_candidates_for_auto_ml_job(**kwargs)#

List the candidates created for the job.

Request Syntax

response = client.list_candidates_for_auto_ml_job(
    AutoMLJobName='string',
    StatusEquals='Completed'|'InProgress'|'Failed'|'Stopped'|'Stopping',
    CandidateNameEquals='string',
    SortOrder='Ascending'|'Descending',
    SortBy='CreationTime'|'Status'|'FinalObjectiveMetricValue',
    MaxResults=123,
    NextToken='string'
)

Parameters:

AutoMLJobName (string) –
[REQUIRED]

List the candidates created for the job by providing the job’s name.
StatusEquals (string) – List the candidates for the job and filter by status.
CandidateNameEquals (string) – List the candidates for the job and filter by candidate name.
SortOrder (string) – The sort order for the results. The default is Ascending.
SortBy (string) – The parameter by which to sort the results. The default is Descending.
MaxResults (integer) – List the job’s candidates up to a specified limit.
NextToken (string) – If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

Return type:

dict

Returns:

Response Syntax

{
    'Candidates': [
        {
            'CandidateName': 'string',
            'FinalAutoMLJobObjectiveMetric': {
                'Type': 'Maximize'|'Minimize',
                'MetricName': 'Accuracy'|'MSE'|'F1'|'F1macro'|'AUC'|'RMSE'|'BalancedAccuracy'|'R2'|'Recall'|'RecallMacro'|'Precision'|'PrecisionMacro'|'MAE'|'MAPE'|'MASE'|'WAPE'|'AverageWeightedQuantileLoss',
                'Value': ...,
                'StandardMetricName': 'Accuracy'|'MSE'|'F1'|'F1macro'|'AUC'|'RMSE'|'BalancedAccuracy'|'R2'|'Recall'|'RecallMacro'|'Precision'|'PrecisionMacro'|'MAE'|'MAPE'|'MASE'|'WAPE'|'AverageWeightedQuantileLoss'
            },
            'ObjectiveStatus': 'Succeeded'|'Pending'|'Failed',
            'CandidateSteps': [
                {
                    'CandidateStepType': 'AWS::SageMaker::TrainingJob'|'AWS::SageMaker::TransformJob'|'AWS::SageMaker::ProcessingJob',
                    'CandidateStepArn': 'string',
                    'CandidateStepName': 'string'
                },
            ],
            'CandidateStatus': 'Completed'|'InProgress'|'Failed'|'Stopped'|'Stopping',
            'InferenceContainers': [
                {
                    'Image': 'string',
                    'ModelDataUrl': 'string',
                    'Environment': {
                        'string': 'string'
                    }
                },
            ],
            'CreationTime': datetime(2015, 1, 1),
            'EndTime': datetime(2015, 1, 1),
            'LastModifiedTime': datetime(2015, 1, 1),
            'FailureReason': 'string',
            'CandidateProperties': {
                'CandidateArtifactLocations': {
                    'Explainability': 'string',
                    'ModelInsights': 'string',
                    'BacktestResults': 'string'
                },
                'CandidateMetrics': [
                    {
                        'MetricName': 'Accuracy'|'MSE'|'F1'|'F1macro'|'AUC'|'RMSE'|'BalancedAccuracy'|'R2'|'Recall'|'RecallMacro'|'Precision'|'PrecisionMacro'|'MAE'|'MAPE'|'MASE'|'WAPE'|'AverageWeightedQuantileLoss',
                        'Value': ...,
                        'Set': 'Train'|'Validation'|'Test',
                        'StandardMetricName': 'Accuracy'|'MSE'|'F1'|'F1macro'|'AUC'|'RMSE'|'MAE'|'R2'|'BalancedAccuracy'|'Precision'|'PrecisionMacro'|'Recall'|'RecallMacro'|'LogLoss'|'InferenceLatency'|'MAPE'|'MASE'|'WAPE'|'AverageWeightedQuantileLoss'|'Rouge1'|'Rouge2'|'RougeL'|'RougeLSum'|'Perplexity'|'ValidationLoss'|'TrainingLoss'
                    },
                ]
            },
            'InferenceContainerDefinitions': {
                'string': [
                    {
                        'Image': 'string',
                        'ModelDataUrl': 'string',
                        'Environment': {
                            'string': 'string'
                        }
                    },
                ]
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- Candidates (list) –
  
  Summaries about the AutoMLCandidates.
  - (dict) –
    
    Information about a candidate produced by an AutoML training job, including its status, steps, and other properties.
    - CandidateName (string) –
      
      The name of the candidate.
    - FinalAutoMLJobObjectiveMetric (dict) –
      
      The best candidate result from an AutoML training job.
      - Type (string) –
        
        The type of metric with the best result.
      - MetricName (string) –
        
        The name of the metric with the best result. For a description of the possible objective metrics, see AutoMLJobObjective$MetricName.
      - Value (float) –
        
        The value of the metric with the best result.
      - StandardMetricName (string) –
        
        The name of the standard metric. For a description of the standard metrics, see Autopilot candidate metrics.
    - ObjectiveStatus (string) –
      
      The objective’s status.
    - CandidateSteps (list) –
      
      Information about the candidate’s steps.
      - (dict) –
        
        Information about the steps for a candidate and what step it is working on.
        
        CandidateStepType (string) –
        
        Whether the candidate is at the transform, training, or processing step.
        
        CandidateStepArn (string) –
        
        The ARN for the candidate’s step.
        
        CandidateStepName (string) –
        
        The name for the candidate’s step.
    - CandidateStatus (string) –
      
      The candidate’s status.
    - InferenceContainers (list) –
      
      Information about the recommended inference container definitions.
      - (dict) –
        
        A list of container definitions that describe the different containers that make up an AutoML candidate. For more information, see ContainerDefinition.
        
        Image (string) –
        
        The Amazon Elastic Container Registry (Amazon ECR) path of the container. For more information, see ContainerDefinition.
        
        ModelDataUrl (string) –
        
        The location of the model artifacts. For more information, see ContainerDefinition.
        
        Environment (dict) –
        
        The environment variables to set in the container. For more information, see ContainerDefinition.
        
        (string) –
        
        (string) –
    - CreationTime (datetime) –
      
      The creation time.
    - EndTime (datetime) –
      
      The end time.
    - LastModifiedTime (datetime) –
      
      The last modified time.
    - FailureReason (string) –
      
      The failure reason.
    - CandidateProperties (dict) –
      
      The properties of an AutoML candidate job.
      - CandidateArtifactLocations (dict) –
        
        The Amazon S3 prefix to the artifacts generated for an AutoML candidate.
        
        Explainability (string) –
        
        The Amazon S3 prefix to the explainability artifacts generated for the AutoML candidate.
        
        ModelInsights (string) –
        
        The Amazon S3 prefix to the model insight artifacts generated for the AutoML candidate.
        
        BacktestResults (string) –
        
        The Amazon S3 prefix to the accuracy metrics and the inference results observed over the testing window. Available only for the time-series forecasting problem type.
      - CandidateMetrics (list) –
        
        Information about the candidate metrics for an AutoML job.
        
        (dict) –
        
        Information about the metric for a candidate produced by an AutoML job.
        
        MetricName (string) –
        
        The name of the metric.
        
        Value (float) –
        
        The value of the metric.
        
        Set (string) –
        
        The dataset split from which the AutoML job produced the metric.
        
        StandardMetricName (string) –
        
        The name of the standard metric.
        
        Note
        For definitions of the standard metrics, see Autopilot candidate metrics.
    - InferenceContainerDefinitions (dict) –
      
      The mapping of all supported processing unit (CPU, GPU, etc…) to inference container definitions for the candidate. This field is populated for the AutoML jobs V2 (for example, for jobs created by calling CreateAutoMLJobV2) related to image or text classification problem types only.
      - (string) –
        
        Processing unit for an inference container. Currently Autopilot only supports CPU or GPU.
        
        (list) –
        
        Information about the recommended inference container definitions.
        
        (dict) –
        
        A list of container definitions that describe the different containers that make up an AutoML candidate. For more information, see ContainerDefinition.
        
        Image (string) –
        
        The Amazon Elastic Container Registry (Amazon ECR) path of the container. For more information, see ContainerDefinition.
        
        ModelDataUrl (string) –
        
        The location of the model artifacts. For more information, see ContainerDefinition.
        
        Environment (dict) –
        
        The environment variables to set in the container. For more information, see ContainerDefinition.
        
        (string) –
        
        (string) –
- NextToken (string) –
  
  If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

Exceptions

SageMaker.Client.exceptions.ResourceNotFound