

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

# Amazon SageMaker AI 도메인의 기본 설정
<a name="domain-set-defaults"></a>

 SageMaker AI를 사용하면 Amazon SageMaker AI 도메인 수준에서 리소스의 기본값을 설정할 수 있습니다. 이러한 기본값은 도메인 내에서 리소스를 만들 때 사용됩니다. 아래 섹션에서는 도메인의 기본값을 보여주고 기본값 설정 시 컨텍스트 키를 사용하는 방법에 대한 정보를 제공합니다.

**Topics**
+ [도메인 기본값](#domain-set-defaults-domains)
+ [컨텍스트 키](#domain-set-defaults-context)

## 도메인 기본값
<a name="domain-set-defaults-domains"></a>

도메인을 만들거나 업데이트할 때 다음 기본값을 설정할 수 있습니다. 사용자 프로필 및 공유 공간 수준에서 전달된 값은 도메인 수준에서 지정된 기본값보다 우선합니다.
+ [ DefaultUserSettings ](https://docs.aws.amazon.com//sagemaker/latest/APIReference/API_UserSettings.html)
+ DefaultSpaceSettings
**참고**  
`DefaultSpaceSettings`는 `SageMakerImageArn`에 대한 JupyterLab 3 이미지 ARN의 사용만 지원합니다. 자세한 내용은 [Amazon SageMaker Studio Classic에서 JupyterLab 버전 관리](studio-jl.md)섹션을 참조하세요.

  ```
  "DefaultSpaceSettings": { 
        "ExecutionRole": "string",
        "JupyterServerAppSettings": { 
           "DefaultResourceSpec": { 
              "InstanceType": "string",
              "LifecycleConfigArn": "string",
              "SageMakerImageArn": "string",
              "SageMakerImageVersionArn": "string"
           },
           "LifecycleConfigArns": [ "string" ]
        },
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "AppImageConfigName": "string",
                 "ImageName": "string",
                 "ImageVersionNumber": number
              }
           ],
           "DefaultResourceSpec": { 
              "InstanceType": "string",
              "LifecycleConfigArn": "string",
              "SageMakerImageArn": "string",
              "SageMakerImageVersionArn": "string"
           },
           "LifecycleConfigArns": [ "string" ]
        },
        "SecurityGroups": [ "string" ]
     }
  ```

## 컨텍스트 키
<a name="domain-set-defaults-context"></a>

도메인을 만드는 IAM 정책에 컨텍스트 키를 추가할 수 있습니다. 이로 인해 사용자가 해당 필드에 전달할 수 있는 값이 제한됩니다. 다음 목록은 도메인이 지원하는 컨텍스트 키와 이러한 컨텍스트 키가 구현된 위치를 보여줍니다.
+ `sagemaker:ImageArns`
  + ** `DefaultUserSettings`의 일부로 구현됨:** `DefaultUserSettings.JupyterServerAppSettings`와 `DefaultUserSettings.KernelGatewayAppSettings`의 `SagemakerImageArn`, `DefaultUserSettings.KernelGatewayAppSettings`의 `CustomImages`.
  + ** `DefaultSpaceSettings`의 일부로 구현됨:** `DefaultSpaceSettings.JupyterServerAppSettings`와 `DefaultSpaceSettings.KernelGatewayAppSettings`의 `SagemakerImageArn`, `DefaultSpaceSettings.KernelGatewayAppSettings`의 `CustomImages`.
+ `sagemaker:VpcSecurityGroupIds`
  + ** `DefaultUserSettings`의 일부로 구현됨:** `DefaultUserSettings`의 `SecurityGroups`.
  + ** `DefaultSpaceSettings`의 일부로 구현됨:** `DefaultSpaceSettings`의 `SecurityGroups`.
+ `sagemaker:DomainSharingOutputKmsKey`

  ** `DefaultUserSettings`의 일부로 구현됨:** `DefaultSpaceSettings.SharingSettings`의 `S3KmsKeyId`.

 컨텍스트 키를 기본값으로 사용할 때는 사용자가 호환되지 않는 값을 전달하도록 제한할 수 없습니다. 예를 들어, `DefaultUserSettings`와 `DefaultSpaceSettings`의 일부로 설정된 `SageMakerImageArn`의 값은 호환되어야 합니다. 호환되지 않는 기본값은 설정할 수 없습니다.