建立共用空間

重要

允許 Amazon SageMaker 工作室或 Amazon 工作 SageMaker 室經典版創建 Amazon SageMaker 資源的自定義 IAM 政策還必須授予許可才能向這些資源添加標籤。需要向資源添加標籤的權限，因為 Studio 和 Studio 經典版會自動標記它們創建的任何資源。如果 IAM 政策允許 Studio 和 Studio 經典版建立資源，但不允許標記，則在嘗試建立資源時可能會發生 AccessDenied "" 錯誤。如需詳細資訊，請參閱 提供標記資 SageMaker源的權限。

AWS Amazon 的受管政策 SageMaker授予建立 SageMaker 資源的權限，已包含在建立這些資源時新增標籤的權限。

以下主題示範如何在現有 Amazon SageMaker 網域中建立共用空間。如果您在不支援共用空間的情況下建立網域，則必須在現有網域中新增對共用空間的支援，然後才能建立共用空間。

為現有網域新增共用空間支援

您可以使用 SageMaker 主控台或將共 AWS CLI 用空間的支援新增至現有網域。如果網域使用VPC only網路存取，則您只能使用 AWS CLI.

主控台

完成下列程序，即可從 SageMaker 主控台將 Studio 傳統共用空間的支援新增至現有網域。

1. 在以下位置打開 Amazon SageMaker 控制台 https://console.aws.amazon.com/sagemaker/。

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

3. 在 [管理員設定] 下，選擇 [網域

4. 從網域清單中，選取您要開啟網域設定頁面的網域。

5. 在網域詳細資料頁面上，選擇網域設定索引標籤。

6. 選擇編輯。

7. 對於 S pace 預設執行角色，請為網域中建立的所有共用空間設定預設使用的 IAM 角色。

8. 選擇下一步。

9. 選擇下一步。

10. 選擇下一步。

11. 選擇提交。

AWS CLI

Studio Classic

從本機電腦的終端機執行下列命令，以從中將預設共用空間設定新增至網域 AWS CLI。如果要將預設共用空間設定新增至 Amazon VPC 內的網域，則還必須包含安全群組清單。工作室經典共享空間僅支持使用 JupyterLab 3 個圖像 ARN。如需詳細資訊，請參閱 JupyterLab 版本化。

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=system,SageMakerImageArn=sagemaker-image-arn}},SecurityGroups=[security-groups]"

使用下列命令來確認預設的共用空間設定已更新。

aws --region region \
sagemaker describe-domain \
--domain-id domain-id

JupyterLab

從本機電腦的終端機執行下列命令，以從中將預設共用空間設定新增至網域 AWS CLI。如果要將預設共用空間設定新增至 Amazon VPC 內的網域，則還必須包含安全群組清單。工作室經典共享空間僅支持使用 JupyterLab 4 個圖像 ARN。如需詳細資訊，請參閱 JupyterLab 版本化。

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn", JupyterLabAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn, SecurityGroups=[security-groups]"

使用下列命令來確認預設的共用空間設定已更新。

aws --region region \
sagemaker describe-domain \
--domain-id domain-id

建立共用空間

以下各節將示範如何從 Amazon 主 SageMaker 控台、Amazon SageMaker 工作室或 AWS CLI.

從工作室創建

請使用下列程序在 Studio 的網域中建立共用空間。

Studio Classic

1. 按照中的步驟導覽至工作室推出 Amazon SageMaker 工作。

2. 在工作室用戶界面中，找到左側的應用程序窗格。

3. 從應用程式窗格中，選取工作室傳統版。

4. 選擇創建工作室經典空間

5. 在快顯視窗中，輸入空間的名稱。

6. 選擇 [建立空間]。

JupyterLab

1. 按照中的步驟導覽至工作室推出 Amazon SageMaker 工作。

2. 在工作室用戶界面中，找到左側的應用程序窗格。

3. 在「應用程式」窗格中，選取JupyterLab。

4. 選擇建立 JupyterLab 空間

5. 在快顯視窗中，輸入空間的名稱。

6. 選擇 [建立空間]。

從主控台建立

請完成下列程序，從 SageMaker 主控台在網域中建立共用空間。

1. 在以下位置打開 Amazon SageMaker 控制台 https://console.aws.amazon.com/sagemaker/。

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

3. 在 [管理員設定] 下，選擇 [網域

4. 從網域清單中，選取您要為其建立共用空間的網域。

5. 在網域詳細資料頁面上，選擇空間管理索引標籤。

6. 選擇建立。

7. 輸入共用空間的名稱。網域中的共用空間名稱必須是唯一的。共用空間的執行角色設定為網域 IAM 執行角色。

建立自 AWS CLI

本節說明如何從 AWS CLI建立共用空間。

建立或更新共用空間時，您無法設定共用空間的執行角色。只DefaultDomainExecRole能在建立或更新網域時設定。共用空間僅支援使用 JupyterLab 3 個映像 ARN。如需詳細資訊，請參閱 JupyterLab 版本化。

若要從建立共用空間 AWS CLI，請從本機電腦的終端機執行下列其中一個命令。

Studio Classic

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

JupyterLab

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--ownership-settings "{"OwnerUserProfileName": "user-profile-name"}" \
--space-sharing-settings "{"SharingType": "Shared"}" \
--space-settings "{"AppType": "JupyterLab"}"