

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

# 在 Amazon SageMaker Studio 用户界面中隐藏实例类型和图片
<a name="studio-updated-ui-customize-instances-images"></a>

**重要**  
截至 2023 年 11 月 30 日，之前的亚马逊 SageMaker Studio 体验现在被命名为 Amazon St SageMaker udio Classic。以下部分专门介绍如何使用更新后的 Studio 体验。有关使用 Studio Classic 应用程序的信息，请参阅 [亚马逊 SageMaker Studio 经典版](studio.md)。

本主题介绍如何隐藏 Amazon A SageMaker I 实例类型和在 Amazon SageMaker Studio 用户界面 (UI) 中显示的图像。有关 Studio UI 的信息，请参阅 [亚马逊 SageMaker 工作室用户界面概述](studio-updated-ui.md)。

当你隐藏 SageMaker AI 实例类型和图像时：
+ 受影响的用户将无法在 Studio UI 中查看隐藏的资源。
+ 受影响的用户将无法使用隐藏配置运行或创建新空间。
+ 受影响用户当前正在运行的任何空间都不会受到影响。
+ 当受影响的用户尝试运行带有隐藏资源的空间时，他们将收到管理员已禁用相关资源的通知。

**注意**  
如果不希望*隐藏*，而是希望通过 AWS Identity and Access Management 策略*限制*用户可用的实例类型，请参阅：  
[我能否限制数据科学家可以启动的用于训练 SageMaker AI 作业的实例类型？](https://repost.aws/questions/QUd77APmdHTx-2FZCvZfS6Qg/can-i-limit-the-type-of-instances-that-data-scientists-can-launch-for-training-jobs-in-sagemaker) 在 re AWS : post 中。
[通过中的 IAM 策略限制 Amazon A SageMaker I 上的实例类型](https://stackoverflow.com/questions/76426316/limiting-instances-types-on-aws-sagemaker-via-iam-policy) StackOverflow。

自定义 Studio 用户界面功能在 Amazon SageMaker Studio 经典版中不可用。

您可以在域级别和用户级别上自定义 Studio UI：
+ 域级别上的自定义会为域中的所有用户设置默认值。
+ 用户层面的定制将优先于域层面的设置。

通过以下主题了解有关不同自定义级别的更多信息以及如何应用它们。

**Topics**
+ [在域级别隐藏实例类型和映像](studio-updated-ui-customize-instances-images-domain.md)
+ [在用户级别隐藏实例类型和映像](studio-updated-ui-customize-instances-images-user.md)

# 在域级别隐藏实例类型和映像
<a name="studio-updated-ui-customize-instances-images-domain"></a>

以下内容展示了如何使用控制台设置规则，以隐藏 Amazon A SageMaker I 实例类型和图像，使其不在*域级别*的 Amazon SageMaker Studio Classic UI 中显示。有关更多信息，请参阅 [在 Amazon SageMaker Studio 用户界面中隐藏实例类型和图片](studio-updated-ui-customize-instances-images.md)。

一旦在域级别上进行了这些更改：
+ 这些变化不会影响目前的任何开放空间。
+ 从那时起，这些更改将影响域用户的*默认*可见性。

  这些默认设置适用于域中所有*未*对其个人用户设置进行更改的用户。
+ 用户级设置优先于域级设置。

自定义 Studio 用户界面功能在 Amazon SageMaker Studio 经典版中不可用。

## 在域级指令（管理控制台）上隐藏实例类型和映像
<a name="studio-updated-ui-customize-instances-images-domain-instructions-console"></a>

**在域级别上隐藏实例类型和映像 Studio UI（控制台）**

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左侧导航窗格中，选择**管理员配置**。

1. 在**管理员配置**下，选择**域**。

1. 从域列表中选择要编辑的域链接。

1. 在**域详细信息**页面上，选择**域设置**。

1. 在**域设置**选项卡中，可以在**域规则**部分查看域规则。

1. 在**域规则**部分选择**管理规则**。

1. 在**管理域规则**页面选择**规则类型**。

   请注意，并非所有 AWS 区域都提供所有实例类型和映像。

   1. 如果您选择**实例类型**，则可以使用 “**隐藏**” 操作来隐藏您在实例类型下拉列表中选择的 SageMaker AI **实例类型**。

   1. 如果选择 “**图像**”，则可以使用 “**隐藏**” 操作来隐藏在 “ SageMaker 图像” 下拉列表下选择的**图像**。

1. （可选）选择 **\$1 添加新规则**添加更多规则。

1. 查看更改后，选择**提交**。

完成后，您将在页面顶部看到一条包含成功信息的绿色横幅。

## 在域级指令中隐藏实例类型和映像 (AWS CLI)
<a name="studio-updated-ui-customize-instances-images-domain-instructions-cli"></a>

**注意**  
要使用此功能，您可能需要更新到最新 AWS CLI 版本。有关更多信息，请参阅[安装或更新到最新版本的 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

您可以使用在 AWS CLI 网域级别自定义 Studio 用户界面中显示的 SageMaker AI 实例和图像[StudioWebPortalSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_StudioWebPortalSettings.html)。`HiddenInstanceTypes`用于隐藏实例类型和`HiddenSageMakerImageVersionAliases`用于隐藏 SageMaker 图像。

请注意，使用 `HiddenSageMakerImageVersionAliases` 时：
+ API 只接受次要 `VersionAliases`（例如 `1.9`），而不是补丁版本（例如 `1.9.1`）。
+ 您可以通过 CLI 或 SDK 输入未发布的版本。不过，这些版本将不会显示在管理控制台中，并会在通过管理控制台编辑规则后被覆盖。

在以下示例中，对于基于 Code-OSS 的代码编辑器、Visual Studio Code-Open Source 以及 JupyterLab，默认情况下，以下内容在域中对用户隐藏：`domainId`
+ 实例类型 `ml.r6id.24xlarge` 和 `ml.r6id.32xlarge`。
+ 映像 `sagemaker_distribution` 版本 `1.9` 和 `1.8`。

```
aws sagemaker update-domain \
    --domain-id domainId \
    --default-user-settings '{
        "StudioWebPortalSettings": {
            "HiddenInstanceTypes": [ "ml.r6id.24xlarge", "ml.r6id.32xlarge" ],
            "HiddenSageMakerImageVersionAliases": [
                {
                    "SageMakerImageName": "sagemaker_distribution",
                    "VersionAliases": [ "1.9", "1.8" ]
                }
            ]
        }
    }'
```

请注意，并非所有 AWS 区域都提供所有实例类型和映像。

# 在用户级别隐藏实例类型和映像
<a name="studio-updated-ui-customize-instances-images-user"></a>

**警告**  
自定义用户配置文件是一项永久性操作。如果保存了自定义设置，该用户配置文件将覆盖域设置，今后不再随域动态更新。

以下内容展示了如何使用控制台设置规则，以隐藏 Amazon A SageMaker I 实例类型和图像，使其不在*用户级别*的 Amazon SageMaker Studio Classic UI 中显示。有关更多信息，请参阅 [在 Amazon SageMaker Studio 用户界面中隐藏实例类型和图片](studio-updated-ui-customize-instances-images.md)。

该设置将优先于域级别设置。

Studio Classic 中不提供自定义 Studio UI 功能。

## 在用户级别指令（管理控制台）上隐藏实例类型和映像
<a name="studio-updated-ui-customize-instances-images-user-instructions-console"></a>

**在用户级别隐藏实例类型和映像 Studio UI（控制台）**

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)。

1. 在左侧导航窗格中，选择**管理员配置**。

1. 在**管理员配置**下，选择**域**。

1. 从域列表中选择要编辑的域链接。

1. 在**域详细信息**页面上，选择**用户配置文件**选项卡。

1. 在**用户配置文件**部分，选择要编辑的用户配置文件链接。

1. 在“用户详情”选项卡上，可以在“用户配置文件规则”部分查看应用于用户的规则。

1. 在“用户配置文件规则”部分选择“管理规则”。

1. 在“管理用户配置文件规则”页面选择规则类型。

   请注意，并非所有 AWS 区域都提供所有实例类型和映像。

   1. 如果您选择**实例类型**，则可以使用 “**隐藏**” 操作来隐藏您在实例类型下拉列表中选择的 SageMaker AI **实例类型**。

   1. 如果选择 “**图像**”，则可以使用 “**隐藏**” 操作来隐藏在 “ SageMaker 图像” 下拉列表下选择的**图像**。

1. （可选）选择 **\$1 添加新规则**添加更多规则。

1. 查看更改后，选择**提交**。

完成后，您将在页面顶部看到一条包含成功信息的绿色横幅。

## 在用户级别指令 (AWS CLI) 上隐藏实例类型和映像
<a name="studio-updated-ui-customize-instances-images-user-instructions-cli"></a>

**注意**  
要使用此功能，您可能需要更新到最新 AWS CLI 版本。有关更多信息，请参阅[安装或更新到最新版本的 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

您可以使用在 AWS CLI 用户级别自定义 Studio 中显示的应用程序和机器学习工具[StudioWebPortalSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_StudioWebPortalSettings.html)。`HiddenInstanceTypes`用于隐藏实例类型和`HiddenSageMakerImageVersionAliases`用于隐藏 SageMaker 图像。

请注意，使用 `HiddenSageMakerImageVersionAliases` 时：
+ API 只接受次要 `VersionAliases`（例如 `1.9`），而不是补丁版本（例如 `1.9.1`）。
+ 您可以通过 CLI 或 SDK 输入未发布的版本。不过，这些版本将不会显示在管理控制台中，并会在通过管理控制台编辑规则后被覆盖。

在以下示例中，对于基于 Code-OSS 的代码编辑器、Visual Studio Code-Open Source 以及 JupyterLab，对域`userProfileName`中的用户隐藏了以下内容：`domainId`
+ 实例类型 `ml.r6id.24xlarge` 和 `ml.r6id.32xlarge`。
+ 映像 `sagemaker_distribution` 版本 `1.9` 和 `1.8`。

```
aws sagemaker update-user-profile \
    --domain-id domainId \
    --user-profile-name userProfileName \
    --user-settings '{
        "StudioWebPortalSettings": {
            "HiddenInstanceTypes": [ "ml.r6id.24xlarge", "ml.r6id.32xlarge" ],
            "HiddenSageMakerImageVersionAliases": [
                {
                    "SageMakerImageName": "sagemaker_distribution",
                    "VersionAliases": [ "1.9", "1.8" ]
                }
            ]
        }
    }'
```

请注意，并非所有 AWS 区域都提供所有实例类型和映像。