Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-143021,9861.6 MB

Starts a recommendation job. You can create either an instance recommendation or load test job.

post/#X-Amz-Target=SageMaker.CreateInferenceRecommendationsJob

Headers

X-Amz-Target'SageMaker.CreateInferenceRecommendationsJob' required

Request body

JobNamestring required

A name for the recommendation job. The name must be unique within the Amazon Web Services Region and within your Amazon Web Services account. The job name is passed down to the resources created by the recommendation job. The names of resources (such as the model, endpoint configuration, endpoint, and compilation) that are prefixed with the job name are truncated at 40 characters.

JobType'Default' | 'Advanced' required

Defines the type of recommendation job. Specify <code>Default</code> to initiate an instance recommendation and <code>Advanced</code> to initiate a load test. If left unspecified, Amazon SageMaker Inference Recommender will run an instance recommendation (<code>DEFAULT</code>) job.

RoleArnstring required

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

JobDescriptionstring

Description of the recommendation job.

Response

Success

JobArnstring required

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