本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 網域使用者設定檔
<a name="domain-user-profile"></a>

使用者設定檔代表 Amazon SageMaker AI 網域內的單一使用者。使用者設定檔的主要方式是參照一個使用者，用於共享、報告和其他使用者導向功能。此實體是在使用者加入 Amazon SageMaker AI 網域時建立的。使用者設定檔可以在共用空間內容之外擁有 (最多) 單一 JupyterServer 應用程式。使用者設定檔的 Studio Classic 應用程式與使用者設定檔直接相關聯，並具有隔離的 Amazon EFS 目錄、與使用者設定檔相關聯的執行角色，以及核心閘道應用程式。使用者設定檔也可以從主控台或 Amazon SageMaker Studio 建立其他應用程式。

**Topics**
+ [新增使用者設定檔](domain-user-profile-add.md)
+ [移除使用者設定檔](domain-user-profile-remove.md)
+ [檢視網域中的使用者設定檔](domain-user-profile-view.md)
+ [檢視用戶描述檔詳細](domain-user-profile-describe.md)

# 新增使用者設定檔
<a name="domain-user-profile-add"></a>

下節說明如何使用 SageMaker AI 主控台或 AWS CLI，將使用者設定檔新增至網域。

將使用者設定檔新增至網域後，使用者可以使用 URL 登入。如果網域使用 AWS IAM Identity Center 進行身分驗證，使用者會收到一封電子郵件，其中包含登入網域的 URL。如果網域使用 AWS Identity and Access Management，您可以使用 [CreatePresignedDomainUrl](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreatePresignedDomainUrl.html) 為使用者設定檔建立 URL

## 從主控台新增使用者設定檔
<a name="domain-user-profile-add-console"></a>

您可以遵循此程序，從 SageMaker AI 主控台將使用者設定檔新增至網域。

1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左側導覽窗格中，選擇**管理員組態**。

1. 在**管理員組態**下，選擇**網域**。

1. 從網域清單中，選取您要將使用者設定檔新增至其中的網域。

1. 在**網域詳細資訊**頁面上，選擇**使用者設定檔**索引標籤。

1. 選擇**新增使用者**。這會開啟新頁面。

1. 使用您的使用者設定檔的預設名稱或新增自訂名稱。

1. 對於**執行角色**，請從角色選擇器中選擇選項。如果您選擇**輸入自訂 IAM 角色 ARN**，則該角色至少必須具有授與 SageMaker AI 擔任角色許可的信任政策。如需詳細資訊，請參閱 [SageMaker AI 角色](https://docs.aws.amazon.com//sagemaker/latest/dg/sagemaker-roles.html)。

   如果您選擇**建立新角色**，**建立 IAM 角色**對話方塊隨即開啟：

   1. 在**您指定的 S3 儲存貯體** 中，指定筆記本的使用者可以存取的其他 Amazon S3 儲存貯體。如果您不想將存取許可新增至更多儲存貯體，請選擇**無**。

   1. 選擇建**立角色**。SageMaker AI 會建立新 IAM 角色，即 `AmazonSageMaker-ExecutionPolicy`，並連接 [AmazonSageMakerFullAccess](https://console.aws.amazon.com//iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess) 政策。

1. (選用) 將標籤新增至使用者設定檔。使用者設定檔建立的所有資源都會有網域 ARN 標籤和使用者設定檔 ARN 標籤。網域 ARN 標籤是以網域識別碼為基礎，而使用者設定檔 ARN 標籤則以使用者設定檔名稱為基礎。

1. 選擇**下一步**。

1. 在 **SageMaker Studio** 區段中，您可以選擇較新還是 Classic 版本的 Studio 作為預設體驗。
   + 如果您選擇 **SageMaker Studio** (建議) 作為預設體驗，則 Studio Classic IDE 具有預設設定。如需預設設定的相關資訊，請參閱[預設設定](onboard-quick-start.md#onboard-quick-start-defaults)。

     如需 Studio 的相關資訊，請參閱 [Amazon SageMaker Studio](studio-updated.md)。
   + 如果選擇 **Studio Classic** 作為預設體驗，您可以選擇啟用或停用筆記本資源共用。筆記本資源包含成品，例如儲存格輸出和 Git 儲存庫。如需筆記本資源的詳細資訊，請參閱[共用和使用 Amazon SageMaker Studio Classic 筆記本](notebooks-sharing.md)。

1. 在 **SageMaker Canvas** 下，您可以設定 SageMaker Canvas 設定。如需加入的指示和組態詳細資訊，請參閱 [Amazon Sagemaker Canvas 使用入門](canvas-getting-started.md)。

   1. 對於**Canvas 基礎許可組態**，請選取是否要建立使用 SageMaker Canvas 應用程式所需的最低許可。

1. 在 **RStudio** 下，如果是 RStudio 授權，請選取是否要使用下列其中一個授權建立使用者：
   + 未經授權
   + RStudio 管理員
   + RStudio 使用者

1. 選擇**下一步**。

1. 在**自訂 Studio UI** 頁面中，您可以自訂 Studio 中顯示的可檢視應用程式和機器學習 (ML) 工具。此自訂只會隱藏 Studio 左側導覽窗格中的應用程式和 ML 工具。如需 Studio UI 的相關資訊，請參閱[Amazon SageMaker Studio UI 概觀](studio-updated-ui.md)。

   如需應用程式的相關資訊，請參閱[Amazon SageMaker Studio 中支援的應用程式](studio-updated-apps.md)。

   Studio Classic 不提供自訂 Studio UI 功能。如果您想要將 Studio 設定為預設體驗，請選擇**上一個**並返回上一個步驟。

1. 選擇**下一步**。

1. 在檢閱了您的變更之後，請選擇**建立使用者設定檔**。

## 從 建立使用者設定檔 AWS CLI
<a name="domain-user-profile-add-cli"></a>

若要從 在網域中建立使用者設定檔 AWS CLI，請從本機電腦的終端機執行下列命令。如需有關 JupyterLab 可用版本 ARN 的詳細資訊，請參閱[設定預設 JupyterLab 版本](studio-jl.md#studio-jl-set)。

```
aws --region region \
sagemaker create-user-profile \
--domain-id domain-id \
--user-profile-name user-name \
--user-settings '{
  "JupyterServerAppSettings": {
    "DefaultResourceSpec": {
      "SageMakerImageArn": "sagemaker-image-arn",
      "InstanceType": "system"
    }
  }
}'
```

您可以使用 AWS CLI ，使用 [StudioWebPortalSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_StudioWebPortalSettings.html) 為使用者自訂 Studio 中顯示的應用程式和 ML 工具。使用 `HiddenAppTypes` 隱藏應用程式和使用 `HiddenMlTools` 隱藏 ML 工具。如需自訂 Studio UI 左側導覽的詳細資訊，請參閱[在 Amazon SageMaker Studio UI 中隱藏機器學習工具和應用程式](studio-updated-ui-customize-tools-apps.md)。此功能不適用於 Studio Classic。

# 移除使用者設定檔
<a name="domain-user-profile-remove"></a>

必須刪除使用者設定檔啟動的所有應用程式和使用者設定檔擁有的所有空間，才能刪除使用者設定檔。下節說明如何使用 SageMaker AI 主控台或 AWS CLI，將使用者設定檔從網域移除。

## 從主控台移除使用者設定檔
<a name="domain-user-profile-remove-console"></a>

1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左側導覽窗格中，選擇**管理員組態**。

1. 在**管理員組態**下，選擇**網域**。

1. 從網域清單中，選取您要從中移除使用者設定檔的網域。

1. 在**網域詳細資訊**頁面上，選擇**使用者設定檔**索引標籤。

1. 選取您要刪除的使用者設定檔。

1. 在 **使用者詳細資訊**頁面上，對於**應用程式**清單中的每個非失敗應用程式，選擇 **動作**。

1. 從下拉式選單中選擇**刪除**。

1. 在 **刪除應用程式** 對話方塊中，選擇**是，刪除應用程式**。然後在確認欄位中，輸入*刪除*，並且選擇**刪除**。

1. 當所有應用程式的**狀態**顯示為**已刪除**時，請導覽回**網域詳細資訊**頁面，然後選擇**空間管理**索引標籤。

1. 刪除使用者設定檔擁有的任何空間。對於使用者設定檔為擁有者的每個空間，選取空間，然後選擇**刪除**。如需詳細步驟，請參閱[刪除 Studio 空間](studio-updated-running-stop.md#studio-updated-running-stop-space)。

1. 返回**使用者設定檔**索引標籤，然後選擇**編輯**。

1. 在**編輯使用者**頁面，選擇**刪除使用者**。

1. 在**刪除使用者**彈出視窗中，選擇 **是，刪除使用者**。

1. 輸入 *刪除*到欄位中，以確認刪除。

1. 選擇 **刪除**。

## 從 移除使用者設定檔 AWS CLI
<a name="domain-user-profile-remove-cli"></a>

若要從 刪除使用者設定檔 AWS CLI，請先刪除使用者設定檔擁有的任何空格，然後刪除使用者設定檔。從本機電腦的終端執行下列命令。

```
# Delete spaces owned by the user profile
aws sagemaker delete-space \
--region region \
--domain-id domain-id \
--space-name space-name

# Delete the user profile
aws sagemaker delete-user-profile \
--region region \
--domain-id domain-id \
--user-profile-name user-name
```

# 檢視網域中的使用者設定檔
<a name="domain-user-profile-view"></a>

 下節說明如何從 SageMaker AI 主控台或 AWS CLI檢視網域中使用者設定檔的清單。

## 從主控台檢視使用者設定檔
<a name="domain-user-profile-view-console"></a>

 完成下列程序，從 SageMaker AI 主控台檢視網域中使用者設定檔的清單。

1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左側導覽窗格中，選擇**管理員組態**。

1. 在**管理員組態**下，選擇**網域**。

1. 從網域清單中，選取您要檢視其使用者設定檔清單的網域。

1. 在**網域詳細資訊**頁面上，選擇**使用者設定檔**索引標籤。

## 從 檢視使用者設定檔 AWS CLI
<a name="domain-user-profile-view-cli"></a>

若要從 檢視網域中的使用者設定檔 AWS CLI，請從本機電腦的終端機執行下列命令。

```
aws sagemaker list-user-profiles \
--region region \
--domain-id domain-id
```

# 檢視用戶描述檔詳細
<a name="domain-user-profile-describe"></a>

下節說明如何從 SageMaker AI 主控台或 AWS CLI檢視網域中使用者設定檔的詳細資料。

## 從主控台檢視使用者設定檔詳細資訊
<a name="domain-user-profile-describe-console"></a>

 完成下列程序，從 SageMaker AI 主控台檢視使用者設定檔的詳細資訊。

1. 開啟 Amazon SageMaker AI 主控台，網址為 [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左側導覽窗格中，選擇**管理員組態**。

1. 在**管理員組態**下，選擇**網域**。

1.  從網域清單中，選取您要檢視其使用者設定檔清單的網域。

1. 在**網域詳細資訊**頁面上，選擇**使用者設定檔**索引標籤。

1.  選取您要檢視詳細資訊的使用者設定檔。

## 從 檢視使用者設定檔詳細資訊 AWS CLI
<a name="domain-user-profile-describe-cli"></a>

若要從 描述使用者設定檔 AWS CLI，請從本機機器的終端機執行下列命令。

```
aws sagemaker describe-user-profile \
--region region \
--domain-id domain-id \
--user-profile-name user-name
```