SageMaker / Client / list_inference_recommendations_jobs

list_inference_recommendations_jobs#

SageMaker.Client.list_inference_recommendations_jobs(**kwargs)#

Lists recommendation jobs that satisfy various filters.

See also: AWS API Documentation

Request Syntax

response = client.list_inference_recommendations_jobs(
    CreationTimeAfter=datetime(2015, 1, 1),
    CreationTimeBefore=datetime(2015, 1, 1),
    LastModifiedTimeAfter=datetime(2015, 1, 1),
    LastModifiedTimeBefore=datetime(2015, 1, 1),
    NameContains='string',
    StatusEquals='PENDING'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'STOPPING'|'STOPPED',
    SortBy='Name'|'CreationTime'|'Status',
    SortOrder='Ascending'|'Descending',
    NextToken='string',
    MaxResults=123,
    ModelNameEquals='string',
    ModelPackageVersionArnEquals='string'
)
Parameters:
  • CreationTimeAfter (datetime) – A filter that returns only jobs created after the specified time (timestamp).

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

  • LastModifiedTimeAfter (datetime) – A filter that returns only jobs that were last modified after the specified time (timestamp).

  • LastModifiedTimeBefore (datetime) – A filter that returns only jobs that were last modified before the specified time (timestamp).

  • NameContains (string) – A string in the job name. This filter returns only recommendations whose name contains the specified string.

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

  • SortBy (string) – The parameter by which to sort the results.

  • SortOrder (string) – The sort order for the results.

  • NextToken (string) – If the response to a previous ListInferenceRecommendationsJobsRequest request was truncated, the response includes a NextToken. To retrieve the next set of recommendations, use the token in the next request.

  • MaxResults (integer) – The maximum number of recommendations to return in the response.

  • ModelNameEquals (string) – A filter that returns only jobs that were created for this model.

  • ModelPackageVersionArnEquals (string) – A filter that returns only jobs that were created for this versioned model package.

Return type:

dict

Returns:

Response Syntax

{
    'InferenceRecommendationsJobs': [
        {
            'JobName': 'string',
            'JobDescription': 'string',
            'JobType': 'Default'|'Advanced',
            'JobArn': 'string',
            'Status': 'PENDING'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'STOPPING'|'STOPPED',
            'CreationTime': datetime(2015, 1, 1),
            'CompletionTime': datetime(2015, 1, 1),
            'RoleArn': 'string',
            'LastModifiedTime': datetime(2015, 1, 1),
            'FailureReason': 'string',
            'ModelName': 'string',
            'SamplePayloadUrl': 'string',
            'ModelPackageVersionArn': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • InferenceRecommendationsJobs (list) –

      The recommendations created from the Amazon SageMaker Inference Recommender job.

      • (dict) –

        A structure that contains a list of recommendation jobs.

        • JobName (string) –

          The name of the job.

        • JobDescription (string) –

          The job description.

        • JobType (string) –

          The recommendation job type.

        • JobArn (string) –

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

        • Status (string) –

          The status of the job.

        • CreationTime (datetime) –

          A timestamp that shows when the job was created.

        • CompletionTime (datetime) –

          A timestamp that shows when the job completed.

        • RoleArn (string) –

          The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

        • LastModifiedTime (datetime) –

          A timestamp that shows when the job was last modified.

        • FailureReason (string) –

          If the job fails, provides information why the job failed.

        • ModelName (string) –

          The name of the created model.

        • SamplePayloadUrl (string) –

          The Amazon Simple Storage Service (Amazon S3) path where the sample payload is stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix).

        • ModelPackageVersionArn (string) –

          The Amazon Resource Name (ARN) of a versioned model package.

    • NextToken (string) –

      A token for getting the next set of recommendations, if there are any.