SageMaker / Paginator / ListInferenceRecommendationsJobSteps

ListInferenceRecommendationsJobSteps

class SageMaker.Paginator.ListInferenceRecommendationsJobSteps

paginator = client.get_paginator('list_inference_recommendations_job_steps')

paginate(**kwargs)

Creates an iterator that will paginate through responses from SageMaker.Client.list_inference_recommendations_job_steps().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    JobName='string',
    Status='PENDING'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'STOPPING'|'STOPPED',
    StepType='BENCHMARK',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• JobName (string) –

  [REQUIRED]

  The name for the Inference Recommender job.

• Status (string) – A filter to return benchmarks of a specified status. If this field is left empty, then all benchmarks are returned.

• StepType (string) –

  A filter to return details about the specified type of subtask.

  BENCHMARK: Evaluate the performance of your model on different instance types.

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Steps': [
        {
            'StepType': 'BENCHMARK',
            'JobName': 'string',
            'Status': 'PENDING'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'STOPPING'|'STOPPED',
            'InferenceBenchmark': {
                'Metrics': {
                    'CostPerHour': ...,
                    'CostPerInference': ...,
                    'MaxInvocations': 123,
                    'ModelLatency': 123,
                    'CpuUtilization': ...,
                    'MemoryUtilization': ...
                },
                'EndpointConfiguration': {
                    'EndpointName': 'string',
                    'VariantName': 'string',
                    'InstanceType': 'ml.t2.medium'|'ml.t2.large'|'ml.t2.xlarge'|'ml.t2.2xlarge'|'ml.m4.xlarge'|'ml.m4.2xlarge'|'ml.m4.4xlarge'|'ml.m4.10xlarge'|'ml.m4.16xlarge'|'ml.m5.large'|'ml.m5.xlarge'|'ml.m5.2xlarge'|'ml.m5.4xlarge'|'ml.m5.12xlarge'|'ml.m5.24xlarge'|'ml.m5d.large'|'ml.m5d.xlarge'|'ml.m5d.2xlarge'|'ml.m5d.4xlarge'|'ml.m5d.12xlarge'|'ml.m5d.24xlarge'|'ml.c4.large'|'ml.c4.xlarge'|'ml.c4.2xlarge'|'ml.c4.4xlarge'|'ml.c4.8xlarge'|'ml.p2.xlarge'|'ml.p2.8xlarge'|'ml.p2.16xlarge'|'ml.p3.2xlarge'|'ml.p3.8xlarge'|'ml.p3.16xlarge'|'ml.c5.large'|'ml.c5.xlarge'|'ml.c5.2xlarge'|'ml.c5.4xlarge'|'ml.c5.9xlarge'|'ml.c5.18xlarge'|'ml.c5d.large'|'ml.c5d.xlarge'|'ml.c5d.2xlarge'|'ml.c5d.4xlarge'|'ml.c5d.9xlarge'|'ml.c5d.18xlarge'|'ml.g4dn.xlarge'|'ml.g4dn.2xlarge'|'ml.g4dn.4xlarge'|'ml.g4dn.8xlarge'|'ml.g4dn.12xlarge'|'ml.g4dn.16xlarge'|'ml.r5.large'|'ml.r5.xlarge'|'ml.r5.2xlarge'|'ml.r5.4xlarge'|'ml.r5.12xlarge'|'ml.r5.24xlarge'|'ml.r5d.large'|'ml.r5d.xlarge'|'ml.r5d.2xlarge'|'ml.r5d.4xlarge'|'ml.r5d.12xlarge'|'ml.r5d.24xlarge'|'ml.inf1.xlarge'|'ml.inf1.2xlarge'|'ml.inf1.6xlarge'|'ml.inf1.24xlarge'|'ml.c6i.large'|'ml.c6i.xlarge'|'ml.c6i.2xlarge'|'ml.c6i.4xlarge'|'ml.c6i.8xlarge'|'ml.c6i.12xlarge'|'ml.c6i.16xlarge'|'ml.c6i.24xlarge'|'ml.c6i.32xlarge'|'ml.g5.xlarge'|'ml.g5.2xlarge'|'ml.g5.4xlarge'|'ml.g5.8xlarge'|'ml.g5.12xlarge'|'ml.g5.16xlarge'|'ml.g5.24xlarge'|'ml.g5.48xlarge'|'ml.p4d.24xlarge'|'ml.c7g.large'|'ml.c7g.xlarge'|'ml.c7g.2xlarge'|'ml.c7g.4xlarge'|'ml.c7g.8xlarge'|'ml.c7g.12xlarge'|'ml.c7g.16xlarge'|'ml.m6g.large'|'ml.m6g.xlarge'|'ml.m6g.2xlarge'|'ml.m6g.4xlarge'|'ml.m6g.8xlarge'|'ml.m6g.12xlarge'|'ml.m6g.16xlarge'|'ml.m6gd.large'|'ml.m6gd.xlarge'|'ml.m6gd.2xlarge'|'ml.m6gd.4xlarge'|'ml.m6gd.8xlarge'|'ml.m6gd.12xlarge'|'ml.m6gd.16xlarge'|'ml.c6g.large'|'ml.c6g.xlarge'|'ml.c6g.2xlarge'|'ml.c6g.4xlarge'|'ml.c6g.8xlarge'|'ml.c6g.12xlarge'|'ml.c6g.16xlarge'|'ml.c6gd.large'|'ml.c6gd.xlarge'|'ml.c6gd.2xlarge'|'ml.c6gd.4xlarge'|'ml.c6gd.8xlarge'|'ml.c6gd.12xlarge'|'ml.c6gd.16xlarge'|'ml.c6gn.large'|'ml.c6gn.xlarge'|'ml.c6gn.2xlarge'|'ml.c6gn.4xlarge'|'ml.c6gn.8xlarge'|'ml.c6gn.12xlarge'|'ml.c6gn.16xlarge'|'ml.r6g.large'|'ml.r6g.xlarge'|'ml.r6g.2xlarge'|'ml.r6g.4xlarge'|'ml.r6g.8xlarge'|'ml.r6g.12xlarge'|'ml.r6g.16xlarge'|'ml.r6gd.large'|'ml.r6gd.xlarge'|'ml.r6gd.2xlarge'|'ml.r6gd.4xlarge'|'ml.r6gd.8xlarge'|'ml.r6gd.12xlarge'|'ml.r6gd.16xlarge'|'ml.p4de.24xlarge'|'ml.trn1.2xlarge'|'ml.trn1.32xlarge'|'ml.inf2.xlarge'|'ml.inf2.8xlarge'|'ml.inf2.24xlarge'|'ml.inf2.48xlarge',
                    'InitialInstanceCount': 123
                },
                'ModelConfiguration': {
                    'InferenceSpecificationName': 'string',
                    'EnvironmentParameters': [
                        {
                            'Key': 'string',
                            'ValueType': 'string',
                            'Value': 'string'
                        },
                    ],
                    'CompilationJobName': 'string'
                },
                'FailureReason': 'string',
                'EndpointMetrics': {
                    'MaxInvocations': 123,
                    'ModelLatency': 123
                },
                'InvocationEndTime': datetime(2015, 1, 1),
                'InvocationStartTime': datetime(2015, 1, 1)
            }
        },
    ],

}

Response Structure

• (dict) –

  • Steps (list) –

    A list of all subtask details in Inference Recommender.

    • (dict) –

      A returned array object for the Steps response field in the ListInferenceRecommendationsJobSteps API command.

      • StepType (string) –

        The type of the subtask.

        BENCHMARK: Evaluate the performance of your model on different instance types.

      • JobName (string) –

        The name of the Inference Recommender job.

      • Status (string) –

        The current status of the benchmark.

      • InferenceBenchmark (dict) –

        The details for a specific benchmark.

        • Metrics (dict) –

          The metrics of recommendations.

          • CostPerHour (float) –

            Defines the cost per hour for the instance.

          • CostPerInference (float) –

            Defines the cost per inference for the instance .

          • MaxInvocations (integer) –

            The expected maximum number of requests per minute for the instance.

          • ModelLatency (integer) –

            The expected model latency at maximum invocation per minute for the instance.

          • CpuUtilization (float) –

            The expected CPU utilization at maximum invocations per minute for the instance.

            NaN indicates that the value is not available.

          • MemoryUtilization (float) –

            The expected memory utilization at maximum invocations per minute for the instance.

            NaN indicates that the value is not available.

        • EndpointConfiguration (dict) –

          The endpoint configuration made by Inference Recommender during a recommendation job.

          • EndpointName (string) –

            The name of the endpoint made during a recommendation job.

          • VariantName (string) –

            The name of the production variant (deployed model) made during a recommendation job.

          • InstanceType (string) –

            The instance type recommended by Amazon SageMaker Inference Recommender.

          • InitialInstanceCount (integer) –

            The number of instances recommended to launch initially.

        • ModelConfiguration (dict) –

          Defines the model configuration. Includes the specification name and environment parameters.

          • InferenceSpecificationName (string) –

            The inference specification name in the model package version.

          • EnvironmentParameters (list) –

            Defines the environment parameters that includes key, value types, and values.

            • (dict) –

              A list of environment parameters suggested by the Amazon SageMaker Inference Recommender.

              • Key (string) –

                The environment key suggested by the Amazon SageMaker Inference Recommender.

              • ValueType (string) –

                The value type suggested by the Amazon SageMaker Inference Recommender.

              • Value (string) –

                The value suggested by the Amazon SageMaker Inference Recommender.

          • CompilationJobName (string) –

            The name of the compilation job used to create the recommended model artifacts.

        • FailureReason (string) –

          The reason why a benchmark failed.

        • EndpointMetrics (dict) –

          The metrics for an existing endpoint compared in an Inference Recommender job.

          • MaxInvocations (integer) –

            The expected maximum number of requests per minute for the instance.

          • ModelLatency (integer) –

            The expected model latency at maximum invocations per minute for the instance.

        • InvocationEndTime (datetime) –

          A timestamp that shows when the benchmark completed.

        • InvocationStartTime (datetime) –

          A timestamp that shows when the benchmark started.