

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon SageMaker Studio Classic AWS CLI の からデフォルトを設定する
<a name="studio-lcc-defaults-cli"></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) には、それらのリソースの作成中にタグを追加するためのアクセス許可もあらかじめ含まれています。

**重要**  
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)することをお勧めします。

次のリソース AWS CLI に対して、 からデフォルトのライフサイクル設定スクリプトを設定できます。
+ ドメイン
+ ユーザープロファイル
+ 共有スペース

以下のセクションでは、 AWS CLIを使用してデフォルトのライフサイクル設定スクリプトを設定する方法の概要を説明します。

**Topics**
+ [前提条件](#studio-lcc-defaults-cli-prereq)
+ [新しいリソースの作成時にデフォルトのライフサイクル設定を設定する](#studio-lcc-defaults-cli-new)
+ [既存リソースのデフォルトのライフサイクル設定を設定する](#studio-lcc-defaults-cli-existing)

## 前提条件
<a name="studio-lcc-defaults-cli-prereq"></a>

開始する前に、次の前提条件を完了します。
+ [現在の AWS CLI バージョンのインストール](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled)の AWS CLI 手順に従って、 を更新します。
+ ローカルマシンで `aws configure` を実行し、 AWS 認証情報を入力します。 AWS 認証情報の詳細については、[AWS 「認証情報の理解と取得](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)」を参照してください。
+ 「[Amazon SageMaker AI ドメインの概要](gs-studio-onboard.md)」の手順に従って、SageMaker AI ドメインにオンボードします。
+ 「[ライフサイクル設定を作成して Amazon SageMaker Studio Classic に関連付ける](studio-lcc-create.md)」の手順に従って、ライフサイクル設定を作成します。

## 新しいリソースの作成時にデフォルトのライフサイクル設定を設定する
<a name="studio-lcc-defaults-cli-new"></a>

新しいドメイン、ユーザープロファイル、またはスペースを作成するときにデフォルトのライフサイクル設定を設定するには、次のいずれかの AWS CLI コマンドの一部として、以前に作成したライフサイクル設定の ARN を渡します。
+ [create-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-user-profile.html)
+ [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/create-domain.html)
+ [create-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-space.html)

KernelGateway または JupyterServer のデフォルト設定で、次の値のライフサイクル設定 ARN を渡す必要があります。
+ `DefaultResourceSpec`:`LifecycleConfigArn` - アプリケーションタイプのデフォルトのライフサイクル設定を指定します。
+ `LifecycleConfigArns` - アプリケーションタイプにアタッチされているすべてのライフサイクル設定のリストです。デフォルトのライフサイクル設定もこのリストに含まれている必要があります。

例えば、次の API コールは、デフォルトのライフサイクル設定を持つ新しいユーザープロファイルを作成します。

```
aws sagemaker create-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"KernelGatewayAppSettings": {
    "DefaultResourceSpec": { 
            "InstanceType": "ml.t3.medium",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'
```

## 既存リソースのデフォルトのライフサイクル設定を設定する
<a name="studio-lcc-defaults-cli-existing"></a>

既存のリソースのデフォルトのライフサイクル設定を設定または更新するには、次のいずれかの AWS CLI コマンドの一部として、以前に作成したライフサイクル設定の ARN を渡します。
+ [update-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-user-profile.html)
+ [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html)
+ [update-space](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-space.html)

KernelGateway または JupyterServer のデフォルト設定で、次の値のライフサイクル設定 ARN を渡す必要があります。
+ `DefaultResourceSpec`:`LifecycleConfigArn` - アプリケーションタイプのデフォルトのライフサイクル設定を指定します。
+ `LifecycleConfigArns` - アプリケーションタイプにアタッチされているすべてのライフサイクル設定のリストです。デフォルトのライフサイクル設定もこのリストに含まれている必要があります。

例えば、次の API コールは、デフォルトのライフサイクル設定を持つユーザープロファイルを更新します。

```
aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--region region \
--user-settings '{
"KernelGatewayAppSettings": {
    "DefaultResourceSpec": {
            "InstanceType": "ml.t3.medium",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'
```

次の API コールは、ドメインを更新して新しいデフォルトのライフサイクル設定を設定します。

```
aws sagemaker update-domain --domain-id domain-id \
--region region \
--default-user-settings '{
"JupyterServerAppSettings": {
    "DefaultResourceSpec": {
            "InstanceType": "system",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'
```