Open RStudio Launcher and launch RSessions - Amazon SageMaker
Open RStudio LauncherLaunch RSessionsSuspend your RSessionsDelete your RSessions
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).

Open RStudio Launcher and launch RSessions

Important

Custom IAM policies that allow Amazon SageMaker Studio or Amazon SageMaker Studio Classic to create Amazon SageMaker resources must also grant permissions to add tags to those resources. The permission to add tags to resources is required because Studio and Studio Classic automatically tag any resources they create. If an IAM policy allows Studio and Studio Classic to create resources but does not allow tagging, "AccessDenied" errors can occur when trying to create resources. For more information, see Provide permissions for tagging SageMaker resources.

Amazon Managed Policies for Amazon SageMaker that give permissions to create SageMaker resources already include permissions to add tags while creating those resources.

The following topics show how to use the RStudio Launcher to launch RSessions.

Open RStudio Launcher

Open the RStudio launcher using the following set of procedures that matches your environment.

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

  2. From the left navigation, select RStudio.

  3. Under Get Started, select the domain and user profile to launch.

  4. Choose Launch RStudio.

  1. Navigate to Studio following the steps in Launch Amazon SageMaker Studio.

  2. Under Applications, select RStudio.

  3. From the RStudio landing page, choose Launch application.

The procedure to open the RStudio Launcher using the Amazon CLI differs depending on the method used to manage your users.

IAM Identity Center

  1. Use the Amazon access portal to open your Amazon SageMaker domain.

  2. Modify the URL path to “/rstudio/default” as follows. 

    #Studio URL
https://<domain-id>.studio.<region>.sagemaker.aws/jupyter/default/lab

#modified URL
https://<domain-id>.studio.<region>.sagemaker.aws/rstudio/default

IAM

To open the RStudio Launcher from the Amazon CLI in IAM mode, complete the following procedure.

  1. Create a presigned URL using the following command. 

    aws sagemaker create-presigned-domain-url --region <REGION> \
    --domain-id <DOMAIN-ID> \
    --user-profile-name <USER-PROFILE-NAME>

  2. Append &redirect=RStudioServerPro to the generated URL.

  3. Navigate to the updated URL.

Launch RSessions

After you’ve launched the RStudio Launcher, you can create a new RSession.

  1. Select New Session.

  2. Enter a Session Name.

  3. Select an instance type that your RSession runs on. This defaults to ml.t3.medium.

  4. Select an Image that your RSession uses as the kernel.

  5. Select Start Session.

  6. After your session has been created, you can start it by selecting the name. 

    Note

    If you receive a warning that there is a version mismatch between your RSession and RStudioServerPro apps, then you must upgrade the version of your RStudioServerPro app. For more information, see Upgrade the RStudio Version.

Suspend your RSessions

  1. From the RStudio Launcher, identify the RSession that you want to suspend.

  2. Select Suspend for the session.

Delete your RSessions

  1. From the RStudio Launcher, identify the RSession that you want to delete.

  2. Select Quit for the session. This opens a new Quit Session window.

  3. From the Quit Session window, select Force Quit, to end all child processes in the session.

  4. Select Quit Session to confirm deletion of the session.