

# Launch Amazon SageMaker Studio
<a name="studio-updated-launch"></a>

**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 AI resources](security_iam_id-based-policy-examples.md#grant-tagging-permissions).  
[Amazon managed policies for Amazon SageMaker AI](security-iam-awsmanpol.md) that give permissions to create SageMaker resources already include permissions to add tags while creating those resources.

**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](studio.md).

 This page's topics demonstrate how to launch Amazon SageMaker Studio from the Amazon SageMaker AI console and the Amazon Command Line Interface (Amazon CLI). 

**Topics**
+ [Prerequisites](#studio-updated-launch-prereq)
+ [Launch from the Amazon SageMaker AI console](#studio-updated-launch-console)
+ [Launch using the Amazon CLI](#studio-updated-launch-cli)

## Prerequisites
<a name="studio-updated-launch-prereq"></a>

 Before you begin, complete the following prerequisites: 
+ Onboard to a SageMaker AI domain with Studio access. If you don't have permissions to set Studio as the default experience for your domain, contact your administrator. For more information, see [Amazon SageMaker AI domain overview](gs-studio-onboard.md). 
+ Update the Amazon CLI by following the steps in [Installing the current Amazon CLI Version](https://docs.amazonaws.cn//cli/latest/userguide/install-cliv1.html#install-tool-bundled). 
+ From your local machine, run `aws configure` and provide your Amazon credentials. For information about Amazon credentials, see [Understanding and getting your Amazon credentials](https://docs.amazonaws.cn//general/latest/gr/aws-sec-cred-types.html).

## Launch from the Amazon SageMaker AI console
<a name="studio-updated-launch-console"></a>

Complete the following procedure to launch Studio from the Amazon SageMaker AI console.

1. Open the Amazon SageMaker AI console at [https://console.amazonaws.cn/sagemaker/](https://console.amazonaws.cn/sagemaker/).

1.  From the left navigation pane, choose Studio. 

1.  From the Studio landing page, select the domain and user profile for launching Studio. 

1.  Choose **Open Studio**. 

1.  To launch Studio, choose **Launch personal Studio**. 

## Launch using the Amazon CLI
<a name="studio-updated-launch-cli"></a>

This section demonstrates how to launch Studio using the Amazon CLI. The procedure to access Studio using the Amazon CLI depends if the domain uses Amazon Identity and Access Management (IAM) authentication or Amazon IAM Identity Center authentication. You can use the Amazon CLI to launch Studio by creating a presigned domain URL when your domain uses IAM authentication. For information about launching Studio with IAM Identity Center authentication, see [Use custom setup for Amazon SageMaker AI](onboard-custom.md). 

### Launch if Studio is the default experience
<a name="studio-updated-launch-console-updated"></a>

 The following code snippet demonstrates how to launch Studio from the Amazon CLI using a presigned domain URL if Studio is the default experience. For more information, see [create-presigned-domain-url](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-presigned-domain-url.html). 

```
aws sagemaker create-presigned-domain-url \
--region region \
--domain-id domain-id \
--user-profile-name user-profile-name \
--session-expiration-duration-in-seconds 43200
```

### Launch if Amazon SageMaker Studio Classic is your default experience
<a name="studio-updated-launch-console-classic"></a>

 The following code snippet demonstrates how to launch Studio from the Amazon CLI using a presigned domain URL if Studio Classic is the default experience. For more information, see [create-presigned-domain-url](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-presigned-domain-url.html). 

```
aws sagemaker create-presigned-domain-url \
--region region \
--domain-id domain-id \
--user-profile-name user-profile-name \
--session-expiration-duration-in-seconds 43200 \
--landing-uri studio::
```