AWS::SageMaker::Domain UserSettings
A collection of settings that apply to users of Amazon SageMaker Studio. These
settings are specified when the CreateUserProfile API is called, and as DefaultUserSettings
when the CreateDomain API
is called.
SecurityGroups
is aggregated when specified in both calls. For all other
settings in UserSettings
, the values specified in
CreateUserProfile
take precedence over those specified in
CreateDomain
.
Syntax
To declare this entity in your Amazon CloudFormation template, use the following syntax:
JSON
{ "CodeEditorAppSettings" :
CodeEditorAppSettings
, "CustomFileSystemConfigs" :[ CustomFileSystemConfig, ... ]
, "CustomPosixUserConfig" :CustomPosixUserConfig
, "DefaultLandingUri" :String
, "ExecutionRole" :String
, "JupyterLabAppSettings" :JupyterLabAppSettings
, "JupyterServerAppSettings" :JupyterServerAppSettings
, "KernelGatewayAppSettings" :KernelGatewayAppSettings
, "RSessionAppSettings" :RSessionAppSettings
, "RStudioServerProAppSettings" :RStudioServerProAppSettings
, "SecurityGroups" :[ String, ... ]
, "SharingSettings" :SharingSettings
, "SpaceStorageSettings" :DefaultSpaceStorageSettings
, "StudioWebPortal" :String
, "StudioWebPortalSettings" :StudioWebPortalSettings
}
YAML
CodeEditorAppSettings:
CodeEditorAppSettings
CustomFileSystemConfigs:- CustomFileSystemConfig
CustomPosixUserConfig:CustomPosixUserConfig
DefaultLandingUri:String
ExecutionRole:String
JupyterLabAppSettings:JupyterLabAppSettings
JupyterServerAppSettings:JupyterServerAppSettings
KernelGatewayAppSettings:KernelGatewayAppSettings
RSessionAppSettings:RSessionAppSettings
RStudioServerProAppSettings:RStudioServerProAppSettings
SecurityGroups:- String
SharingSettings:SharingSettings
SpaceStorageSettings:DefaultSpaceStorageSettings
StudioWebPortal:String
StudioWebPortalSettings:StudioWebPortalSettings
Properties
CodeEditorAppSettings
-
The Code Editor application settings.
SageMaker applies these settings only to private spaces that the user creates in the domain. SageMaker doesn't apply these settings to shared spaces.
Required: No
Type: CodeEditorAppSettings
Update requires: No interruption
CustomFileSystemConfigs
-
The settings for assigning a custom file system to a user profile. Permitted users can access this file system in Amazon SageMaker Studio.
SageMaker applies these settings only to private spaces that the user creates in the domain. SageMaker doesn't apply these settings to shared spaces.
Required: No
Type: Array of CustomFileSystemConfig
Minimum:
0
Maximum:
2
Update requires: No interruption
CustomPosixUserConfig
-
Details about the POSIX identity that is used for file system operations.
SageMaker applies these settings only to private spaces that the user creates in the domain. SageMaker doesn't apply these settings to shared spaces.
Required: No
Type: CustomPosixUserConfig
Update requires: No interruption
DefaultLandingUri
-
The default experience that the user is directed to when accessing the domain. The supported values are:
-
studio::
: Indicates that Studio is the default experience. This value can only be passed ifStudioWebPortal
is set toENABLED
. -
app:JupyterServer:
: Indicates that Studio Classic is the default experience.
Required: No
Type: String
Maximum:
1023
Update requires: No interruption
-
ExecutionRole
-
The execution role for the user.
SageMaker applies this setting only to private spaces that the user creates in the domain. SageMaker doesn't apply this setting to shared spaces.
Required: Yes
Type: String
Pattern:
^arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+$
Minimum:
20
Maximum:
2048
Update requires: No interruption
JupyterLabAppSettings
-
The settings for the JupyterLab application.
SageMaker applies these settings only to private spaces that the user creates in the domain. SageMaker doesn't apply these settings to shared spaces.
Required: No
Type: JupyterLabAppSettings
Update requires: No interruption
JupyterServerAppSettings
-
The Jupyter server's app settings.
Required: No
Type: JupyterServerAppSettings
Update requires: No interruption
KernelGatewayAppSettings
-
The kernel gateway app settings.
Required: No
Type: KernelGatewayAppSettings
Update requires: No interruption
RSessionAppSettings
-
A collection of settings that configure the
RSessionGateway
app.Required: No
Type: RSessionAppSettings
Update requires: No interruption
RStudioServerProAppSettings
-
A collection of settings that configure user interaction with the
RStudioServerPro
app.Required: No
Type: RStudioServerProAppSettings
Update requires: No interruption
SecurityGroups
-
The security groups for the Amazon Virtual Private Cloud (VPC) that the domain uses for communication.
Optional when the
CreateDomain.AppNetworkAccessType
parameter is set toPublicInternetOnly
.Required when the
CreateDomain.AppNetworkAccessType
parameter is set toVpcOnly
, unless specified as part of theDefaultUserSettings
for the domain.Amazon SageMaker adds a security group to allow NFS traffic from Amazon SageMaker Studio. Therefore, the number of security groups that you can specify is one less than the maximum number shown.
SageMaker applies these settings only to private spaces that the user creates in the domain. SageMaker doesn't apply these settings to shared spaces.
Required: No
Type: Array of String
Minimum:
0
Maximum:
32 | 5
Update requires: No interruption
SharingSettings
-
Specifies options for sharing Amazon SageMaker Studio notebooks.
Required: No
Type: SharingSettings
Update requires: No interruption
SpaceStorageSettings
-
The storage settings for a space.
SageMaker applies these settings only to private spaces that the user creates in the domain. SageMaker doesn't apply these settings to shared spaces.
Required: No
Type: DefaultSpaceStorageSettings
Update requires: No interruption
StudioWebPortal
-
Whether the user can access Studio. If this value is set to
DISABLED
, the user cannot access Studio, even if that is the default experience for the domain.Required: No
Type: String
Allowed values:
ENABLED | DISABLED
Update requires: No interruption
StudioWebPortalSettings
-
Studio settings. If these settings are applied on a user level, they take priority over the settings applied on a domain level.
Required: No
Type: StudioWebPortalSettings
Update requires: No interruption