JupyterLab administrator guide - Amazon SageMaker
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).

JupyterLab administrator guide

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.

This guide for administrators describes SageMaker JupyterLab resources, such as those from Amazon Elastic Block Store (Amazon EBS) and Amazon Elastic Compute Cloud (Amazon EC2). The topics also show how to provide user access and change storage size.

A SageMaker JupyterLab space is composed of the following resources:

  • A distinct Amazon EBS volume that stores all of the data, such as the code and the environment variables.

  • The Amazon EC2 instance used to run the space.

  • The image used to run JupyterLab.

Note

Applications do not have access to the EBS volume of other applications. For example, Code Editor, based on Code-OSS, Visual Studio Code - Open Source doesn't have access to the EBS volume for JupyterLab. For more information about EBS volumes, see Amazon Elastic Block Store (Amazon EBS).

You can use the Amazon SageMaker API to do the following:

  • Change the default storage size of the EBS volume for your users.

  • Change the maximum size of the EBS storage

  • Specify the user settings for the application. For example, you can specify whether the user is using a custom image or a code repository.

  • Specify the support application type.

The default size of the Amazon EBS volume is 5 GB. You can increase the volume size to a maximum of 16,384 GB. If you don't do anything, your users can increase their volume size to 100 GB. The volume size can be changed only once within a six hour period.

The kernels associated with the JupyterLab application run on the same Amazon EC2 instance that runs JupyterLab. When you create a space, the latest version of the SageMaker Distribution Image is used by default. For more information about SageMaker Distribution Images, see SageMaker Distribution Images.

Important

For information about updating the space to use the latest version of the SageMaker Distribution Image, see Updating the SageMaker Distribution Image.

The following sections walk you through the configurations that you need to perform as an administrator.

Topics