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

# 建立共用空間
<a name="domain-space-create"></a>

**重要**  
允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授與許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記它們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則在嘗試建立資源時可能會發生 "AccessDenied" 錯誤。如需詳細資訊，請參閱[提供標記 SageMaker AI 資源的許可](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。  
提供許可來建立 SageMaker 資源的 [AWS Amazon SageMaker AI 的 受管政策](security-iam-awsmanpol.md) 已包含建立這些資源時新增標籤的許可。

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

**Topics**
+ [將共用空間支援新增至現有網域](#domain-space-add)
+ [建立共用空間](#domain-space-create-app)

## 將共用空間支援新增至現有網域
<a name="domain-space-add"></a>

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

### 主控台
<a name="domain-space-add-console"></a>

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

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

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

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

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

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

1.  選擇**編輯**。

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

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

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

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

1.  選擇**提交**。

### AWS CLI
<a name="domain-space-add-cli"></a>

------
#### [ Studio Classic ]

從本機機器的終端機執行下列命令，以從 AWS CLI中將預設共用空間設定新增至網域。如果您要將預設共用空間設定新增至 Amazon VPC 中的網域，則還必須包含安全群組清單。Studio Classic 共用空間僅支援使用 JupyterLab 3 映像 ARN。如需詳細資訊，請參閱[Amazon SageMaker Studio Classic 中的 JupyterLab 版本控制](studio-jl.md)。

```
# 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 中的網域，則還必須包含安全群組清單。Studio Classic 共用空間僅支援使用 JupyterLab 4 映像 ARN。如需詳細資訊，請參閱[Amazon SageMaker Studio Classic 中的 JupyterLab 版本控制](studio-jl.md)。

```
# 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
```

------

## 建立共用空間
<a name="domain-space-create-app"></a>

下列各節示範如何從 Amazon SageMaker AI 主控台、Amazon SageMaker Studio 或 AWS CLI建立共用空間。

### 從 Studio 建立
<a name="domain-space-create-updated"></a>

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

------
#### [ Studio Classic ]

1. 遵循[啟動 Amazon SageMaker Studio](studio-updated-launch.md) 中的步驟導覽至 Studio。

1. 從 Studio UI 中，尋找左側的應用程式窗格。

1. 從應用程式窗格中，選取 **Studio Classic**。

1. 選擇**建立 Studio Classic 空間**

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

1. 選擇**建立空間**。

------
#### [ JupyterLab ]

1. 遵循[啟動 Amazon SageMaker Studio](studio-updated-launch.md) 中的步驟導覽至 Studio。

1. 從 Studio UI 中，尋找左側的應用程式窗格。

1. 從應用程式窗格中，選取 **JupyterLab**。

1. 選擇**建立 JupyterLab 空間**

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

1. 選擇**建立空間**。

------

### 從主控台建立
<a name="domain-space-create-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.  輸入共用空間的名稱。網域內的共用空間名稱必須是唯一的。共用空間的執行角色設定為網域 IAM 執行角色。

### 從 建立 AWS CLI
<a name="domain-space-create-cli"></a>

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

建立或更新共用空間時，您無法設定共用空間的執行角色。只有在建立或更新網域時才能設定 `DefaultDomainExecRole`。共用空間僅支援使用 JupyterLab 3 映像 ARN。如需詳細資訊，請參閱[Amazon SageMaker Studio Classic 中的 JupyterLab 版本控制](studio-jl.md)。

若要從 建立共用空間 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\"}"
```

------