

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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 따라를 업데이트합니다. [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled) 
+ 로컬 컴퓨터에서 `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}}]
  }
}'
```