翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 共有スペースでコラボレーション
Amazon SageMaker Studio Classic の共有スペースは、共有 JupyterServer アプリケーションと共有ディレクトリで構成されています。JupyterLab の共有スペースは、Amazon SageMaker Studio 内の共有 JupyterLab アプリケーションと共有ディレクトリで構成されています。ドメイン内のすべてのユーザープロファイルは、そのドメイン内のすべての共有スペースにアクセスできます。Amazon SageMaker AI は、共有スペースで起動した Amazon SageMaker Studio Classic アプリケーションのコンテキスト内で、共有スペース内のリソースの範囲を自動的に設定します。共有スペースのリソースにはノートブック、ファイル、実験、モデルなどがあります。共有スペースを使用して、自動タグ付け、ノートブックのリアルタイム共同編集、カスタマイズなどの機能を使用して、他のユーザーとリアルタイムでコラボレーションできます。
共有スペースは以下で利用可能です。
+ Amazon SageMaker Studio Classic
+ JupyterLab
Studio Classic 共有スペースは、Studio Classic アプリケーションと KernelGateway アプリケーションのみをサポートします。共有スペースは、JupyterLab 3 イメージの Amazon リソースネーム (ARN) の使用のみをサポートします。詳細については、「[Amazon SageMaker Studio Classic での JupyterLab のバージョニング](studio-jl.md)」を参照してください。
Amazon SageMaker AI は、共有スペースの範囲内で作成したすべての SageMaker AI リソースに自動的にタグを付けます。これらのタグを使用して、 AWS Budgetsなどのツールを使用してコストをモニタリングしたり予算を計画したりできます。
共有スペースが使用する VPC 設定は、その共有スペースが作成されたドメインと同じです。
**注記**
共有スペースは Amazon SageMaker Data Wrangler または Amazon EMR クロスアカウントクラスターの使用をサポートしていません。
**自動タグ付け**
共有スペースで作成されたすべてのリソースには、ドメイン ARN タグと共有スペース ARN タグが自動的に追加されます。ドメイン ARN タグはドメイン ID に基づいており、共有スペース ARN タグは共有スペース名に基づいています。
これらのタグを使用して使用状況をモニタリングできます AWS CloudTrail 。詳細については、[「Log Amazon SageMaker API Calls with AWS CloudTrail](https://docs.aws.amazon.com//sagemaker/latest/dg/logging-using-cloudtrail.html)」を参照してください。
これらのタグを使用して、 のコストをモニタリングすることもできます AWS Billing and Cost Management。詳細については、[AWS 「コスト配分タグの使用](https://docs.aws.amazon.com//awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。
**ノートブックのリアルタイム共同編集**
共有スペースの主な利点は、共有スペースのメンバー間のコラボレーションがリアルタイムで簡単に行えることです。ワークスペースでコラボレーションしているユーザーは、共有 Studio Classic アプリケーションにアクセスして、リアルタイムでノートブックにアクセスし、閲覧や編集を行うことができます。リアルタイムコラボレーションは、共有スペース内の JupyterServer アプリケーションでのみサポートされます。
共有スペースにアクセスできるユーザーは、そのスペース内で共有されている Studio Classic アプリケーションまたは JupyterLab アプリケーションで Jupyter Notebook を同時に開いて、表示、編集、実行できます。
ノートブックでは、共同編集を行う各ユーザーを、ユーザープロファイル名を示す異なるカーソルで示します。複数のユーザーが同じノートブックを閲覧できますが、共同編集は 2～5 人の少人数のグループに最適です。
複数のユーザーによる変更を追跡するには、Studio Classic に組み込まれている Git ベースのバージョン管理を使用することを強くお勧めします。
**JupyterServer 2**
Studio Classic で共有スペースを使用するには、Jupyter Server バージョン 2 が必要です。JupyterLab の拡張機能やパッケージの中には、Jupyter Server をバージョン 1 に強制的にダウングレードできるものがあります。これにより、共有スペースは使用できなくなります。コマンドプロンプトで以下を実行すると、バージョン番号を変更して共有スペースを引き続き使用できます。
```
conda activate studio
pip install jupyter-server==2.0.0rc3
```
**共有スペースのカスタマイズ**
ライフサイクル設定またはカスタムイメージをを共有スペースアタッチするには、 AWS CLIを使用する必要があります。ライフサイクル設定の作成やアタッチの詳細については、「[ライフサイクル設定を作成して Amazon SageMaker Studio Classic に関連付ける](studio-lcc-create.md)」を参照してください。カスタムイメージの作成やアタッチの詳細については、「[Amazon SageMaker Studio Classic でのカスタムイメージ](studio-byoi.md)」を参照してください。
# 共有スペースの作成
**重要**
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)
## 共有スペースのサポートを既存のドメインに追加する
SageMaker AI コンソールまたは を使用して AWS CLI 、共有スペースのサポートを既存のドメインに追加できます。ただし、ドメインで `VPC only` ネットワークアクセスを使用している場合、共有スペースのサポートの追加に使用できるのは、 AWS CLIのみです。
### コンソール
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. [**Submit**] を選択してください。
### AWS CLI
------
#### [ 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
```
------
## 共有スペースの作成
次のセクションでは、Amazon SageMaker AI コンソール、Amazon SageMaker Studio、または AWS CLIから共有スペースを作成する方法を説明します。
### Studio からの作成
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. **[スペースを作成]** を選択します。
------
### コンソールからの作成
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
このセクションでは、 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\"}"
```
------
# 共有スペースに関する情報を取得する
**重要**
2023 年 11 月 30 日以降、従来の Amazon SageMaker Studio のエクスペリエンスは Amazon SageMaker Studio Classic と名前が変更されました。以下のセクションは、Studio Classic アプリケーションの使用を前提とした内容です。更新後の Studio エクスペリエンスを使用する場合は、「[Amazon SageMaker Studio](studio-updated.md)」を参照してください。
Studio Classic は既存のワークロードでも維持されていますが、オンボーディングに利用できなくなりました。既存の Studio Classic アプリケーションのみを停止または削除でき、新しいアプリケーションを作成することはできません。[ワークロードを新しい Studio エクスペリエンスに移行](studio-updated-migrate.md)することをお勧めします。
このガイドでは、Amazon SageMaker AI コンソール、Amazon SageMaker Studio、または AWS CLIを使用して、Amazon SageMaker AI ドメイン内の共有スペースのリストにアクセスする方法を説明します。また、 AWS CLIから共有スペースの詳細を表示する方法についても説明します。
**Topics**
+ [共有スペースの一覧表示](#domain-space-list-spaces)
+ [共有スペースの詳細の表示](#domain-space-describe)
## 共有スペースの一覧表示
以下のトピックでは、SageMaker AI コンソールまたは AWS CLIからドメイン内の共有スペースのリストを表示する方法を説明します。
### Studio から共有スペースを一覧表示する
Studio からドメインの共有スペースのリストを表示する手順は以下のとおりです。
1. 「[Amazon SageMaker Studio を起動する](studio-updated-launch.md)」の手順に従って Studio に移動します。
1. Studio UI で、左側にあるアプリケーションペインを見つけます。
1. アプリケーションペインから、**[Studio Classic]** または **[JupyterLab]** を選択します。アプリケーションタイプの実行に使用されているスペースを確認できます。
### コンソールから共有スペースを一覧表示する
SageMaker AI コンソールからドメイン内の共有スペースのリストを表示するには、次の手順を実行します。
1. Amazon SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) を開きます。
1. 左のナビゲーションペインで、**[管理設定]** を選択します。
1. **[管理設定]** で、**[ドメイン]** を選択します。
1. ドメインのリストから、共有スペースのリストを表示するドメインを選択します。
1. **[ドメインの詳細]** ページで、**[スペースの管理]** タブを選択します。
### から共有スペースを一覧表示する AWS CLI
からドメイン内の共有スペースを一覧表示するには AWS CLI、ローカルマシンのターミナルから次のコマンドを実行します。
```
aws --region region \
sagemaker list-spaces \
--domain-id domain-id
```
## 共有スペースの詳細の表示
次のセクションでは、SageMaker AI コンソールまたは AWS CLIから共有スペースの詳細を表示する方法を説明します。
### Studio から共有スペースの詳細を表示する
Studio からドメインの共有スペースの詳細情報を表示する手順は以下のとおりです。
1. 「[Amazon SageMaker Studio を起動する](studio-updated-launch.md)」の手順に従って Studio に移動します。
1. Studio UI で、左側にあるアプリケーションペインを見つけます。
1. アプリケーションペインから、**[Studio Classic]** または **[JupyterLab]** を選択します。アプリケーションを実行しているスペースを確認できます。
1. 詳細情報を表示するスペースの名前を選択します。
### コンソールから共有スペースの詳細を表示する
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
から共有スペースの詳細を表示するには AWS CLI、ローカルマシンのターミナルから次のコマンドを実行します。
```
aws --region region \
sagemaker describe-space \
--domain-id domain-id \
--space-name space-name
```
# 共有スペースの編集
Amazon SageMaker Studio Classic または JupyterLab の共有スペースの詳細情報を編集できるのは、 AWS CLIを使用する場合のみです。Amazon SageMaker AI コンソールから共有スペースの詳細情報を編集することはできません。ワークスペース属性を更新できるのは、共有スペースに実行中のアプリケーションがない場合のみです。
------
#### [ Studio Classic ]
から Studio Classic 共有スペースの詳細を編集するには AWS CLI、ローカルマシンのターミナルから次のいずれかのコマンドを実行します。 共有スペースは JupyterLab 3 イメージ ARNs の使用のみをサポートします。詳細については、「[Amazon SageMaker Studio Classic での JupyterLab のバージョニング](studio-jl.md)」を参照してください。
```
aws --region region \
sagemaker update-space \
--domain-id domain-id \
--space-name space-name \
--query SpaceArn --output text \
--space-settings '{
"JupyterServerAppSettings": {
"DefaultResourceSpec": {
"SageMakerImageArn": "sagemaker-image-arn",
"InstanceType": "system"
}
}
}'
```
------
#### [ JupyterLab ]
から JupyterLab 共有スペースの詳細を編集するには AWS CLI、ローカルマシンのターミナルから次のいずれかのコマンドを実行します。 共有スペースは JupyterLab 4 イメージ ARNs の使用のみをサポートします。詳細については、「[SageMaker JupyterLab](studio-updated-jl.md)」を参照してください。
```
aws --region region \
sagemaker update-space \
--domain-id domain-id \
--space-name space-name \
--space-settings "{
"SpaceStorageSettings": {
"EbsStorageSettings": {
"EbsVolumeSizeInGb":100
}
}
}
}"
```
------
# 共有スペースの削除
**重要**
2023 年 11 月 30 日以降、従来の Amazon SageMaker Studio のエクスペリエンスは Amazon SageMaker Studio Classic と名前が変更されました。以下のセクションは、Studio Classic アプリケーションの使用を前提とした内容です。更新後の Studio エクスペリエンスを使用する場合は、「[Amazon SageMaker Studio](studio-updated.md)」を参照してください。
Studio Classic は既存のワークロードでも維持されていますが、オンボーディングに利用できなくなりました。既存の Studio Classic アプリケーションのみを停止または削除でき、新しいアプリケーションを作成することはできません。[ワークロードを新しい Studio エクスペリエンスに移行](studio-updated-migrate.md)することをお勧めします。
以下のトピックでは、Amazon SageMaker AI コンソールまたは AWS CLIから、Amazon SageMaker Studio Classic の共有スペースを削除する方法を説明します。共有スペースは、実行中のアプリケーションがない場合にのみ削除できます。
**Topics**
+ [コンソール](#domain-space-delete-console)
+ [AWS CLI](#domain-space-delete-cli)
## コンソール
SageMaker AI コンソールから Amazon 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. **[はい、スペースを削除します]** を選択します。
1. フィールドに「削除」と入力します。**
1. **[スペースの削除]** を選択します。
## AWS CLI
から共有スペースを削除するには AWS CLI、ローカルマシンのターミナルから次のコマンドを実行します。
```
aws --region region \
sagemaker delete-space \
--domain-id domain-id \
--space-name space-name
```