からデフォルトを設定する AWS CLI

重要

Amazon SageMaker Studio または Amazon SageMaker Studio Classic が Amazon SageMaker リソースを作成できるようにするカスタム IAM ポリシーは、それらのリソースにタグを追加するアクセス許可も付与する必要があります。Studio と Studio Classic は、作成したリソースに自動的にタグ付けするため、リソースにタグを追加するアクセス許可が必要です。IAM ポリシーで Studio と Studio Classic がリソースの作成を許可されていてもタグ付けが許可されていない場合、リソースの作成時にAccessDenied「」エラーが発生する可能性があります。詳細については、「リソースにタグ付けするための SageMakerアクセス許可を提供する」を参照してください。

AWS Amazon の マネージドポリシー SageMaker SageMaker リソースを作成するアクセス許可を付与する には、それらのリソースの作成中にタグを追加するアクセス許可が既に含まれています。

重要

2023 年 11 月 30 日現在、以前の Amazon SageMaker Studio エクスペリエンスは Amazon SageMaker Studio Classic という名前になりました。次のセクションは、Studio Classic アプリケーションの使用に固有のものです。更新された Studio エクスペリエンスの使用については、「」を参照してくださいAmazon SageMaker Studio。

次のリソース AWS CLI のデフォルトのライフサイクル設定スクリプトは、 から設定できます。

• ドメイン

• ユーザープロファイル

• 共有スペース

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

前提条件

開始する前に、次の前提条件を完了します。

• 「最新バージョン のインストール」の AWS CLI 手順に従って、 を更新します。 AWS CLI

• ローカルマシンで aws configure を実行し、 AWS 認証情報を入力します。 AWS 認証情報の詳細については、「認証情報の理解と取得」を参照してください AWS。

• 「」の手順に従って SageMaker ドメインにオンボードしますAmazon SageMaker ドメインの概要。

• 「ライフサイクル設定の作成と関連付け」の手順に従って、ライフサイクル設定を作成します。

新しいリソースの作成時にデフォルトのライフサイクル設定を設定する

新しいドメイン、ユーザープロファイル、またはスペースを作成するときにデフォルトのライフサイクル設定を設定するには、次のいずれかの AWS CLI コマンドの一部として、以前に作成したライフサイクル設定の ARN を渡します。

• create-user-profile

• create-domain

• create-space

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]
  }
}'

既存リソースのデフォルトのライフサイクル設定を設定する

既存のリソースのデフォルトのライフサイクル設定を設定または更新するには、次のいずれかの AWS CLI コマンドの一部として、以前に作成したライフサイクル設定の ARN を渡します。

• update-user-profile

• update-domain

• update-space

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": "ml.t3.medium",
            "LifecycleConfigArn": "lifecycle-configuration-arn"
         },
    "LifecycleConfigArns": [lifecycle-configuration-arn-list]
  }
}'