为资源添加自定义标签 - 亚马逊 SageMaker AI
先决条件选择加入自定义标签传播添加自定义标签

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

为资源添加自定义标签

下页演示了使用自定义标签传播所需的步骤。自定义标签传播需要以下步骤：

  • 选择加入自定义标签传播

  • 为资源添加自定义标签

在现有域中激活自定义标签传播时，在重新启动应用程序之前，标记传播对现有应用程序不起作用。同样，当添加新的自定义标签时，现有资源上的标记也不会更新。例如，假设一个域有两个标签，用户在该域中创建了一个资源。然后，该资源就有了两个标签。如果域中添加了新标签，则该新标签不会添加到现有资源中。不过，创建的任何新资源都将附加新标签。

先决条件

  • 用户必须拥有 sagemaker:AddTags 权限才能创建任何资源。

    • 对于使用SageMakerFullAccess托管策略或使用 SageMaker 角色管理器创建的新域，sagemaker:AddTags权限已预先填充。

    • 对于使用自定义 AWS Identity and Access Management 策略的现有域，您必须更新策略以包含允许用户创建资源的sagemaker:AddTags权限。

选择加入自定义标签传播

根据从管理控制台还是从 AWS CLI选择加入自定义标签传播，加入过程有所不同。在管理控制台中，您只能通过更新现有域来选择加入自定义标签传播。从中 AWS CLI，您可以在创建域或更新现有域时选择加入自定义标签传播。

从管理控制台选择加入

以下步骤概述了如何从管理控制台选择自定义标签传播。只有通过更新现有域，才能从管理控制台选择加入自定义标签传播。

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

  2. 在左侧导航栏中选择管理配置。在管理配置下，选择域。

  3. 在域页面上，选择要激活自定义标签传播的域。

  4. 在域详细信息页面上，选择域设置选项卡。

  5. 在域设置选项卡上，导航至自定义标签传播。

  6. 选择编辑。

  7. 在编辑自定义标签传播页面上，选择自动传播自定义标签。

  8. 选择提交。

使用 “选择加入” AWS CLI

要选择使用自定义标签传播 AWS CLI，请使用CreateDomain和UpdateDomainAPIs中的TagPropagation属性。默认情况下，该字段的值为 DISABLED。空值也默认为 DISABLED。下面的示例显示了如何激活自定义标签传播。

aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED

添加自定义标签

添加自定义标签传播的过程因您是从管理控制台还是从 AWS CLI添加而有所不同。

从管理控制台添加

以下步骤概述了如何从管理控制台向域添加自定义标签。

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

  2. 在左侧导航栏中选择管理配置。在管理配置下，选择域。

  3. 在域页面上，选择要添加自定义标签的域。

  4. 在域详细信息页面上，选择域设置选项卡。

  5. 在域设置选项卡上，导航至标签。

  6. 选择编辑。

  7. 在标签页面上，选择添加标签。为自定义标签添加键和值对。

  8. 选择保存。现在，此自定义标签已传播到在域中创建的 SageMaker AI 资源。

以下步骤概述了如何从管理控制台向用户配置文件添加自定义标签。

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

  2. 在左侧导航栏中选择管理配置。在管理配置下，选择域。

  3. 在域页面上，选择包含要添加自定义标签的用户配置文件的域。

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

  5. 在用户配置文件选项卡上，选择要添加自定义标签的用户配置文件。

  6. 在用户详细信息选项卡上，导航至详细信息部分。

  7. 选择编辑。

  8. 在标签部分，选择添加标签。为自定义标签添加键和值对。

  9. 选择提交。现在，此自定义标签已传播到在域中创建的 SageMaker AI 资源。

使用添加 AWS CLI

激活自定义标签传播后，可以在创建或更新期间 AWS CLI 在域、用户配置文件或空间级别使用添加自定义标签。添加自定义标签的方法因创建新资源或为现有资源添加标签而异。

下面的示例显示了如何在创建过程中在域级别添加自定义标签。

aws sagemaker create-domain \
    --domain-name domain-id \
    --auth-mode IAM \
    --default-user-settings '{"ExecutionRole": "execution-role"}' \
    --subnet-ids subnet-id \
    --vpc-id vpc-id \
    --tags Key=key,Value=value \
    --tag-propagation ENABLED

您必须使用AddTagsAPI为现有域、用户配置文件和空间添加自定义标签，如下所示。

aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value