View, stop, or delete your Studio running instances, applications, and spaces - Amazon SageMaker
View your Studio running instances, applications, and spacesDelete or stop your Studio running instances, applications, and spaces
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).

View, stop, or delete your Studio running instances, applications, and spaces

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 updated Studio experience. For information about using the Studio Classic application, see Amazon SageMaker Studio Classic.

The following topics include information and instructions about how to view, stop, or delete your Studio running instances, applications, and spaces. For more information about Studio spaces, see Amazon SageMaker Studio spaces.

We briefly give an overview of the differences between a space, application, and instance in the following bullet points:

  • When you create a space, you are creating the necessary resources to run an application. This includes an Amazon Elastic Block Store (Amazon EBS) volume where your data is stored. When you delete a space, you are also deleting your data stored in the space.

  • When you open an application, you will need to start an instance for the application to run on.

    When you close an application, you will not automatically stop and delete the instance. You can reopen the application while the instance is running.

    When you use the DeleteApp API you also stop and delete the instance. You can restart the instance and application after using this API.

  • For the instructions on this page, the action to stop an instance or delete an instance has the same effect. When you stop or delete an instance, you also stop the application.

    Similarly, to stop an instance is the same as to stop or delete an application.

View your Studio running instances, applications, and spaces

View your Studio running instances and applications

The Running instances page gives information about all running application instances that were created in Amazon SageMaker Studio by the user, or were shared with the user.

You can view and stop running instances for all of your applications and spaces. If an instance is stopped, it does not appear on this page. Stopped instances can be viewed from the landing page for their respective application types.

You can view a list of running applications and their details in Studio.

To view running instances

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

  2. On the left navigation pane, choose Running instances.

  3. From the Running instances page, you can view a list of running applications and details about those applications.

    To view non-running instances, from the left navigation pane choose, the relevant application under Applications. The non-running applications will have the Stopped status under the Status column.

View your Studio spaces

The Spaces section within your Domain details page gives information about Studio spaces within your domain. You can view, create, and delete spaces on this page.

The spaces that you can view in the Spaces section are running spaces for the following:

There are no spaces for SageMaker Canvas, Studio Classic (private), or RStudio.

To view Studio spaces in a domain

  1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

  2. From the left navigation pane, expand Admin configurations and choose Domains.

  3. Choose the domain where you want to view the spaces.

  4. On the Domain details page, choose the Space management tab to open the Spaces section.

Delete or stop your Studio running instances, applications, and spaces

To avoid additional charges from unused Studio running instances, applications, or spaces, you can stop or delete them. This page will provide some information about the differences between stopping or deleting your Studio running instances, applications, or spaces, followed by instructions.

For more information about the differences between Studio spaces, application, and instances, see View, stop, or delete your Studio running instances, applications, and spaces.

Delete or stop your Amazon SageMaker Studio application or running instance

To avoid additional charges from unused running applications, you can stop and delete those applications and running instances. The following provides some information on stopping or deleting an application or instance:

  • In the following instructions, to delete an application (uses the DeleteApp API) has the same effect as to stop the instance for the application. Following the instructions to delete an application or stop an instance, both stops and deletes the application and the instance for the application.

  • After you delete an application or stop an instance, you can start up the instance and application again later.

    • When you delete an application or stop an instance, the files in the space will persist. You can run the application again and expect to have access to the same files that are stored in the space, as you did before deleting the application.

    • When you delete an application or stop an instance, the metadata for the application will be deleted within 24 hours. For more information, see the note in the CreationTime response element for the DescribeApp API.

The following tabs provide instructions to stop and delete an application from your domain using the Studio UI, the SageMaker console, or the Amazon CLI.

Note

To view and stop all of your Studio running instances in one location, we recommend the Use the Studio UI to delete your domain applications workflow from the following options.

To delete your Studio applications using the Studio UI, use the following instructions.

To delete your domain applications (Studio UI)

  1. Launch Studio. This process may differ depending on your setup. For information about launching Studio, see Launch Amazon SageMaker Studio.

  2. From the left navigation pane, choose Running instances.

    If the table on the page is empty, you don't have any running instances or applications in your spaces.

  3. In the table under the Name and Application columns, find the space name and the application that you want to stop and delete.

  4. Choose the corresponding Stop button to stop and delete the application.

To view or stop Studio running instances from a centralized location, see Use the Studio UI to delete your domain applications. Otherwise, use the following instructions.

In the SageMaker console, you can only stop the running Studio applications for the spaces that you are able to view in the Spaces section of the console. For a list of the viewable spaces, see View your Studio spaces.

These steps show how to delete your Studio applications by using the SageMaker console.

To delete applications instructions (console)

  1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

  2. From the left navigation pane, expand Admin configurations and choose Domains.

  3. Choose the domain that you want to revert.

  4. On the Domain details page, choose the Space management tab.

  5. Important

    In the Space management tab, you have the option to delete the space. There is a difference between deleting the space and deleting an application. If you delete the space, you will lose access to the data within that space. Do not delete the space unless you're sure that you want to.

    To stop and delete the application, in the Space management tab and under the Name column, choose the space for the application.

  6. In the Apps section and under the App type column, search for the app to stop and delete.

  7. Under the Action column, choose the corresponding Delete app button.

  8. In the pop-up box, choose Yes, delete app. After you do so the delete input field becomes available.

  9. Enter delete in the delete input field to confirm deletion.

  10. Choose Delete.

To view or stop any of your Studio running instances from a centralized location, see Use the Studio UI to delete your domain applications. Otherwise, use the following instructions.

The following code examples use the DeleteApp API to delete an application in an example domain.

To stop your running JupyterLab or Code Editor instances, use the following code example:

aws sagemaker delete-app \
--domain-id example-domain-id \
--region Amazon Web Services Region \
--app-name default \
--app-type example-app-type \
--space-name example-space-name

  • To obtain your example-domain-id, use the following instructions:

    To get example-domain-id

    1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

    2. From the left navigation pane, expand Admin configurations and choose Domains.

    3. Choose the relevant domain.

    4. On the Domain details page, choose the Domain settings tab.

    5. Copy the Domain ID.

  • To obtain your Amazon Web Services Region, use the following instructions to ensure you are using the correct Amazon Web Services Region for your domain:

    To get Amazon Web Services Region

    1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

    2. From the left navigation pane, expand Admin configurations and choose Domains.

    3. Choose the relevant domain.

    4. On the Domain details page, verify that this is the relevant domain.

    5. Expand the region dropdown list from the top right of the SageMaker console, and use the corresponding Amazon Web Services Region ID to the right of your Amazon Web Services Region name. For example, us-west-1.

  • For example-app-type, use the application type that's relevant to the application that you want to stop. For example, replace example-app-type with one of the following application types:

  • To obtain your example-space-name, use the following steps:

    To get example-space-name

    1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

    2. From the left navigation pane, expand Admin configurations and choose Domains.

    3. Choose the relevant domain.

    4. On the Domain details page, choose the Space management tab.

    5. Copy the relevant space name.

To stop running instances for SageMaker Canvas, Studio Classic, or RStudio, use the following code example:

aws sagemaker delete-app \
--domain-id example-domain-id \
--region Amazon Web Services Region \
--app-name default \
--app-type example-app-type \
--user-profile example-user-name

  • For example-app-type, use the application type relevant to the application that you want to stop. For example, replace example-app-type with one of the following application types:

  • To obtain your example-user-name, navigate to the Domain details page.

    • Next, choose the User profiles tab, and copy the relevant space name.

For alternative instructions to delete your running Studio applications, see:

Delete a Studio space

Important

After you delete your space, you will lose all of the data stored in the space. We recommend that you back up your data before deleting your space.

To delete a Studio space, you will need to have administrator permissions or at least have permissions to update domain, IAM and Amazon S3.

  • Spaces are used to manage the storage and resource needs of the relevant application. When you delete a space, the storage volume also deletes. Therefore, you lose access to the files stored on that space. For more information about Studio spaces, see Amazon SageMaker Studio spaces.

    We recommend that you back up your data if you choose to delete a space.

  • After you delete a space, you can't access that space again.

You can delete the Studio spaces that are viewable in the Spaces section of the console. For a list of the viewable spaces, see View your Studio spaces.

There are no spaces for SageMaker Canvas, Studio Classic (private), and RStudio. To stop and delete your SageMaker Canvas, Studio Classic (private), or RStudio applications, see Delete or stop your Amazon SageMaker Studio application or running instance.

The Spaces section within your Domain details page gives information about Studio spaces within you domain. You can view, create, and delete spaces on this page.

To view Studio spaces in a domain

  1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

  2. From the left navigation pane, expand Admin configurations and choose Domains.

  3. Choose the domain where you want to view the spaces.

  4. On the Domain details, choose Space management to open the Spaces section.

  5. Select the space to delete.

  6. Choose Delete.

  7. In the pop-up box titled Delete space, you have two options:

    • If you already shut down all applications in the space, choose Yes, delete space.

    • If you still have applications running in the space, choose Yes, shut down all apps and delete space.

  8. Enter delete in the delete input field to confirm deletion.

  9. To delete the space, you have two options:

    • If you already shut down all applications in the space, choose Delete space.

    • If you still have applications running in the space, choose Shut down all apps and delete space.

Before you can delete a space using the Amazon CLI, you must delete the application associated with it. For information about stopping your Studio applications, see Delete or stop your Amazon SageMaker Studio application or running instance.

Use the following Amazon CLI command to delete a space within a domain:

aws sagemaker delete-space \
--domain-id example-domain-id \
--region Amazon Web Services Region \
--space-name example-space-name

  • To obtain your example-domain-id, use the following instructions:

    To get example-domain-id

    1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

    2. From the left navigation pane, expand Admin configurations and choose Domains.

    3. Choose the relevant domain.

    4. On the Domain details page, choose the Domain settings tab.

    5. Copy the Domain ID.

  • To obtain your Amazon Web Services Region, use the following instructions to ensure you are using the correct Amazon Web Services Region for your domain:

    To get Amazon Web Services Region

    1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

    2. From the left navigation pane, expand Admin configurations and choose Domains.

    3. Choose the relevant domain.

    4. On the Domain details page, verify that this is the relevant domain.

    5. Expand the region dropdown list from the top right of the SageMaker console, and use the corresponding Amazon Web Services Region ID to the right of your Amazon Web Services Region name. For example, us-west-1.

  • To obtain your example-space-name, use the following steps:

    To get example-space-name

    1. Open the Amazon SageMaker console at https://console.aws.amazon.com/sagemaker/.

    2. From the left navigation pane, expand Admin configurations and choose Domains.

    3. Choose the relevant domain.

    4. On the Domain details page, choose the Space management tab.

    5. Copy the relevant space name.