Launch a Solution - Amazon SageMaker
Advanced parameters
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Launch a Solution

Important

As of November 30, 2023, the previous Amazon SageMaker Studio experience is now named Amazon SageMaker Studio Classic. The following section is specific to using the Studio Classic application. For information about using the updated Studio experience, see Amazon SageMaker Studio.

Note

JumpStart Solutions are only available in Studio Classic.

First, choose a solution through the SageMaker JumpStart landing page in the Amazon SageMaker Studio Classic UI. For information on the onboarding steps to sign in to Amazon SageMaker Studio Classic, see Onboard to Amazon SageMaker domain. For details on getting to the SageMaker JumpStart landing page, see Open and use JumpStart in Studio Classic.

After you choose a solution, a solution's tab opens showing a description of the solution and a Launch button. To launch a solution, select Launch in the Launch Solution section. JumpStart then creates all of the resources needed to run the solution. This includes training and model hosting instances.

Advanced parameters

The solution that you choose may have advanced parameters that you can select. Choose Advanced Parameters to specify the Amazon Identity and Access Management role for the solution.

Solutions are able to launch resources across 9 Amazon services that interact with each other. For the solution to work as expected, newly created components from one service must be able to act on newly created components from another service. We recommend that you use the default IAM role to ensure that all needed permissions are added. For more information about IAM roles, see Identity and Access Management for Amazon SageMaker.

Default IAM role

If you select this option, the default IAM roles that are required by this solution are used. Each solution requires different resources. The following list describes the default roles that are used for the solutions based on the service needed. For a description of the permissions required for each service, see Amazon Managed Policies for SageMaker projects and JumpStart.

  • API Gateway – AmazonSageMakerServiceCatalogProductsApiGatewayRole

  • CloudFormation – AmazonSageMakerServiceCatalogProductsCloudformationRole

  • CodeBuild – AmazonSageMakerServiceCatalogProductsCodeBuildRole

  • CodePipeline – AmazonSageMakerServiceCatalogProductsCodePipelineRole

  • Events – AmazonSageMakerServiceCatalogProductsEventsRole

  • Firehose – AmazonSageMakerServiceCatalogProductsFirehoseRole

  • Glue – AmazonSageMakerServiceCatalogProductsGlueRole

  • Lambda – AmazonSageMakerServiceCatalogProductsLambdaRole

  • SageMaker – AmazonSageMakerServiceCatalogProductsExecutionRole

If you are using a new SageMaker domain with JumpStart project templates enabled, these roles are automatically created in your account.

If you are using an existing SageMaker domain, these roles may not exist in your account. If this is the case, you will receive the following error when launching the solution. 

Unable to locate the updated roles required to launch this solution, a general role '/service-role/AmazonSageMakerServiceCatalogProductsUseRole' will be used. Please update your studio domain to generate these roles.

You can still launch a solution without the needed role, but the legacy default role AmazonSageMakerServiceCatalogProductsUseRole is used in place of the needed role. The legacy default role has trust relationships with all of the services that JumpStart solutions need to interact with. For the best security, we recommend that you update your domain to have the newly created default roles for each Amazon service.

If you have already onboarded to a SageMaker domain, you can update your domain to generate the default roles using the following procedure.

  1. Open the Amazon SageMaker console at https://console.amazonaws.cn/sagemaker/.

  2. Choose Control Panel at the top left of the page.

  3. From the domain page, choose the Settings icon ( ) to edit the domain settings.

  4. On General Settings choose Next.

  5. Under SageMaker Projects and JumpStart, select Enable Amazon SageMaker project templates and Amazon SageMaker JumpStart for this account and Enable Amazon SageMaker project templates and Amazon SageMaker JumpStart for Studio Classic users, choose Next.

  6. Select Submit.

You should be able to see the default roles listed in Projects - Amazon SageMaker project templates enabled for this account under the Apps - Studio tab.

Find IAM role

If you select this option, you must select an existing IAM role from the dropdown list for each of the required services. The selected role must have at least the minimum permissions required for the corresponding service. For a description of the permissions required for each service, see Amazon Managed Policies for SageMaker projects and JumpStart.

Input IAM role

If you select this option, you must manually enter the ARN for an existing IAM role. The selected role must have at least the minimum permissions required for the corresponding service. For a description of the permissions required for each service, see Amazon Managed Policies for SageMaker projects and JumpStart.