为域名设置默认值 - Amazon SageMaker
域默认设置上下文键
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

为域名设置默认值

使用 SageMaker，您可以在 Amazon SageMaker 域级别为您的资源设置默认设置。这些默认设置用于在域内创建资源。以下各节列出了域的默认设置，并提供了有关在设置默认值时使用上下文密钥的信息。

域默认设置

创建或更新域时，您可以设置以下默认值。在用户配置文件和共享空间级别传递的值会覆盖在域级别设置的默认值。

  • DefaultUserSettings

  • DefaultSpace设置

    注意

    DefaultSpaceSettings仅支持将 JupyterLab 3 个图像 ARN 用于。SageMakerImageArn有关更多信息，请参阅 JupyterLab 版本控制。

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

上下文键

您可以向创建域的 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 的值必须兼容。不能设置以下不兼容的默认值。有关可用 JupyterLab 版本 ARN 的更多信息，请参阅设置默认 JupyterLab版本。

  • 只能使用 JupyterLab 版本 1 的 ARN 作为中的值 SageMakerImageArn DefaultUserSettings

  • 只能使用 JupyterLab 版本 3 的 ARN 作为中的值 SageMakerImageArn DefaultSpaceSettings